Você precisa do Access Manager v3.20.0 ou posterior. As versões anteriores não aceitam as permissões da TED Lerian.
Passo a passo
1
Escolha onde o parceiro atua
A TED Lerian tem duas restrições. As duas valem para os recursos
transfers e incoming-transfers:A TED Lerian trabalha em uma organização e em um ledger: os que estão configurados para a sua instituição. Veja a configuração em Visão geral da API da TED Lerian. Coloque essa organização, e esse ledger se você restringir por ledger, no escopo do parceiro.
2
Dê ao parceiro as permissões e o escopo
Crie o parceiro, ou altere-o, no Console ou com a API de Identity. O slug do produto é
plugin-br-ted-lerian.- Adicione a entrada de escopo da organização. Sem uma entrada de escopo, o Access Manager recusa o parceiro com
400eIDE-1060. - Para restringir o parceiro a um ledger, adicione também a entrada de escopo do ledger.
- Confira os recursos e as ações. O máximo que você pode dar é o que o papel de editor da TED Lerian tem no seu tenant. Acima disso, o Access Manager recusa com
IDE-1043.
O Access Manager recusa todas as outras permissões com
400 e IDE-1056. Essas permissões agem sobre o tenant inteiro: o desbloqueio e a decisão da análise de fraude de uma transferência, a devolução e as decisões sobre uma TED recebida, a conciliação, os dashboards, a política e os vínculos de ISPB, a lista de participantes, o catálogo de eventos e as configurações de runtime. O Access Manager também recusa com IDE-1056 as permissões marcadas com Não para um parceiro restrito a um ledger. O Console marca essas linhas como Fora do escopo.3
Crie a aplicação de TED Lerian
Crie a aplicação do parceiro com o produto
plugin-br-ted-lerian. Veja Crie as aplicações do parceiro no guia da API, ou no Console. Envie o client ID e o client secret ao parceiro por um canal seguro.4
Informe a organização e o ledger em cada requisição
O parceiro informa a organização no cabeçalho
X-Organization-Id, e o ledger no cabeçalho X-Ledger-Id. Os dois cabeçalhos são opcionais para os outros chamadores. Um parceiro deve enviá-los como esta tabela mostra. Uma requisição sem eles é recusada.Os cabeçalhos não escolhem a organização nem o ledger. A TED Lerian sempre os obtém da sua configuração, e os cabeçalhos apenas os confirmam. A TED Lerian confere cada cabeçalho que lê:
Essa conferência vale para todos os chamadores, também para as aplicações da sua própria instituição.Quando um envio ou uma cotação de tarifa traz
X-Ledger-Id, a conta em X-Account-Id deve ser uma conta desse ledger. Caso contrário, a resposta é 400 com TED-0001. A TED Lerian também faz essa conferência em uma nova tentativa com uma chave X-Idempotency que ela já usou. Ela não repete uma resposta guardada para uma conta de outro ledger.5
Confirme que funciona
Use a credencial de um parceiro com Envie a mesma requisição sem o cabeçalho
transfers:read, restrito apenas à organização. Liste as transferências da organização do escopo do parceiro. A resposta é 200:X-Organization-Id. A resposta é 403 com TED-0071.A restrição de ledger cobre apenas o envio
A TED Lerian lê o ledger apenas quando um parceiro envia uma TED ou obtém uma cotação de tarifa. As leituras, o cancelamento e as TEDs recebidas não trazem ledger. Uma transferência pode estar em um ledger anterior da sua instituição, e uma TED recebida pode estar em qualquer ledger dos vínculos de ISPB. A TED Lerian não as filtra por ledger. Por isso, um parceiro restrito a um ledger pode apenas enviar e obter cotações de tarifa. O Access Manager se recusa a dar a ele
transfers:read, transfers:cancel ou incoming-transfers:read, com 400 e IDE-1056. Para permitir que um parceiro leia ou cancele transferências, restrinja-o apenas à organização.
Um parceiro restrito à organização lê todas as transferências e TEDs recebidas da organização, em todos os ledgers. Dê a ele transfers:read e incoming-transfers:read apenas quando ele puder ver todas elas.
TEDs recebidas sem organização
A TED Lerian atribui cada TED recebida a uma organização. Uma TED recebida que ela ainda não consegue atribuir não tem organização e aguarda em
MANUAL_REVIEW. Um parceiro não vê essas TEDs recebidas:
GET /v1/incoming-transfersnão as lista.GET /v1/incoming-transfers/{incomingTransferId}eGET /v1/incoming-transfers/{incomingTransferId}/timelinerespondem404, como se a TED não existisse.
As regras do parceiro na Midaz não valem para as suas transferências
A TED Lerian chama a Midaz e o CRM com a sua própria credencial, também quando atende um parceiro. As permissões e o escopo do parceiro na Midaz não se aplicam a essas chamadas. A TED Lerian não tem restrição de conta. A conta em
X-Account-Id deve pertencer à organização da TED Lerian, ou a resposta é 403 com TED-0009. Quando a requisição traz X-Ledger-Id, a conta também deve ser uma conta desse ledger, ou a resposta é 400 com TED-0001.
Rotas que nenhum parceiro alcança
Todas as rotas fora da tabela do passo 2 agem sobre o tenant inteiro. Um parceiro não pode ter as permissões dessas rotas, então a TED Lerian o recusa com
403 e TED-0071:
- O desbloqueio e a decisão da análise de fraude de uma transferência.
- A devolução, a decisão de revisão e a decisão da verificação de fraude de uma TED recebida.
- As rotas de conciliação,
/v1/reconciliation/*. - Os dashboards de operações,
/v1/operations/*. - A política e os vínculos de ISPB,
/v1/policy/*. - A lista de participantes,
GET /v1/participants. - As configurações de runtime,
/v1/system/*.
Se algo falhar
O
TED-0071 não diz se foram as permissões ou o escopo que recusaram a requisição. Isso é intencional: um parceiro não consegue usar uma recusa para descobrir quais organizações ou ledgers existem fora do seu escopo.
Uma alteração em um parceiro, como uma suspensão ou um novo escopo, vale na sua próxima requisição, também com um token que ele já tem. Quando a TED Lerian guarda as decisões do Access Manager por um tempo, definido em AUTH_CACHE_TTL, a alteração vale depois desse tempo.
Para todos os outros códigos, veja a lista de erros da TED Lerian. Para as recusas ao criar ou alterar um parceiro, veja Códigos de erro no guia da API.
