Permissionamento para aplicativos
O objetivo deste guia é ajudar você a criar o permissionamento para o seu aplicativo tanto para as ações consumidas, como para ações implementadas.
Pré-requisitos
Contexto
Vamos supor que você tem um aplicativo de logística e deseja integrar com um aplicativo de faturas para poder gerar faturas automaticamente para seus clientes.
Seu aplicativo chama-se Logitrack
e o aplicativo de faturas chama-se Faturando
.
1. Ações implementadas
O aplicativo de logistica quer expor a funcionalidade de rastreamento de entregas para que outros aplicativos possam consumir.
Definindo a permissão interna do seu aplicativo
- Acesse console.iugu.com/apps
- Clique em editar no seu aplicativo
- Clique em Permissões
- No campo Ações Implementadas adicione a ação
track.shipment
- Clique em
- Clique em
Não é necessário adicionar na ação implementada o nome do aplicativo.
Por definição ao criar o aplicativo, o nome do aplicativo se torna o
Prefixo de ação implementada. Ele será lido como nome_do_app:track.shipment
.
2. Ações consumidas
O aplicativo de logistica quer consumir a funcionalidade de geração de faturas do aplicativo de faturas.
Definindo a solicitação de permissões para o aplicativo de faturas
- Acesse console.iugu.com/apps
- Clique em editar no seu aplicativo
- Clique em Permissões
- No campo Ações Consumidas escreva o nome do app
Faturando
e haverá um dropdown com as ações disponíveis, selecionefaturando:generate.invoice
(Faturando não é um aplicativo real, é um placeholder para o app que você realmente quer consumir) - Clique em
- Clique em
Sempre que houver mudanças nas permissões de ações consumidas do seu aplicativo, todos os usuários que utilizam o seu aplicativo deverão autorizar novamente o acesso ao aplicativo que está solicitando a permissão.
Você consegue consumir apenas ações de applicativos instalados na sua área de trabalho.