Skip to main content
Um parceiro é um dos seus próprios clientes que chama a sua plataforma Lerian pelos sistemas dele. O Access Manager dá a cada parceiro aplicações próprias. Você decide o que o parceiro pode fazer e em qual parte dos dados de um produto. Você também decide os endereços de rede e a janela de validade dele.

​
Os blocos de construção

Um parceiro é um registro do seu tenant. As linhas depois dele descrevem o que você define para um parceiro.

​
Produtos que aceitam parceiros

Você pode dar permissões a um parceiro apenas em um produto que aceita parceiros. Um produto aceita parceiros quando publica um catálogo de escopo com a adesão a parceiros. Para ver quais produtos aceitam parceiros no seu deploy, leia os catálogos de escopo com Listar catálogos de escopo. Um produto aceita parceiros quando a entrada dele tem partners: true. Um produto sem entrada não publicou um catálogo de escopo. No Console, a etapa Produtos da página de novo parceiro mostra como indisponíveis os produtos que não aceitam parceiros. Cada produto tem uma página própria com as restrições dele, os campos em que o parceiro nomeia os itens dele e as recusas que ele recebe:

​
O que você precisa saber

  • Cada produto define as próprias dimensões no catálogo de escopo dele. O catálogo diz se uma dimensão é obrigatória e se ela aceita mais de um valor.
  • Um parceiro com permissões em um produto que declara dimensões precisa de escopo nele. Dê a ele pelo menos uma entrada de escopo para esse produto. Sem ela, o Access Manager recusa criar ou alterar o parceiro, com 400 e IDE-1060. Um parceiro salvo antes desta regra, sem entrada de escopo, é recusado com 403 em toda requisição a esse produto até você adicionar uma.
  • A exceção é uma entrada de permissões que tem apenas permissões que o produto reserva para parceiros. Uma entrada assim não precisa de escopo, e vale para o tenant inteiro. No Pix JD, essas são as permissões de canal da JD.
  • Quando um produto marca uma dimensão como obrigatória, um parceiro com permissões nesse produto precisa de uma entrada de escopo para ela. Sem ela, o Access Manager recusa o parceiro com IDE-0001.
  • Fora de uma entrada de permissões reservadas, um parceiro alcança só o que as permissões e o escopo dele permitem, juntos.
  • O Access Manager não confere se os valores de escopo existem no produto. Ele guarda os valores que você informa. Copie-os da própria API ou do Console do produto.
  • Você não pode excluir um parceiro que tem aplicações. Exclua as aplicações dele antes.
  • O Access Manager recusa uma permissão acima do teto com IDE-1043. O Console a marca como Não permitido.

​
Como uma requisição é decidida

Toda requisição que uma aplicação do parceiro envia a um produto é conferida contra o cadastro do parceiro, nesta ordem. A primeira conferência que falha decide a resposta:
  1. Endereço de rede. O endereço de quem chama é conferido com a lista de IPs própria do parceiro, ou com a lista do seu tenant quando o parceiro não tem uma.
  2. Estado. O parceiro tem que estar active.
  3. Janela de validade. A requisição tem que estar dentro da janela de validade do parceiro.
  4. Permissões. O produto, o recurso e a ação têm que estar nas permissões do parceiro.
  5. Escopo. Os itens que a requisição nomeia têm que estar dentro do escopo do parceiro. Uma permissão que o produto reserva para parceiros pula essa verificação.
As duas últimas conferências dão a mesma resposta, então um parceiro não consegue usar uma recusa para descobrir quais itens existem fora do escopo dele. As três primeiras conferências também valem quando o parceiro pede um token. A página de cada produto lista os códigos que o parceiro recebe.

​
Quando uma alteração vale

Toda alteração que você faz num parceiro vale sem um token novo: as permissões, o escopo, o estado, a janela de validade e a lista de IPs.

​
Próximos passos

Gerenciar parceiros no Console

Crie um parceiro passo a passo, crie as aplicações dele, suspenda-o ou exclua-o.

Gerenciar parceiros pela API

As operações de parceiro, os campos delas, exemplos e códigos de erro.

Parceiros no Midaz

Restrinja um parceiro a uma organização e aos ledgers, contas ou rotas dela.

Parceiros no Pix JD

Restrinja um parceiro a um participante direto ou a um participante indireto.

Lista de IPs permitidos

A lista de endereços de rede confiáveis do seu tenant.

Lista de erros