Aplicativos autorizados

A área Integração, Aplicativos autorizados reúne os aplicativos que receberam acesso à sua conta pelo fluxo de autorização da Raims. A mesma autorização atende clientes MCP e outros aplicativos compatíveis, incluindo integrações de plataformas e serviços.

Cada conexão identifica o aplicativo, quem autorizou o acesso, os ambientes e as permissões concedidas. O aplicativo continua sujeito às permissões atuais de quem o autorizou e às regras da conta.

A coluna Autorizado por mostra o identificador de quem concedeu o acesso. Confira esse identificador para distinguir conexões do mesmo aplicativo.

Instalar um aplicativo em outra plataforma e autorizar o acesso à Raims são etapas distintas. Conclua o fluxo apresentado pelo aplicativo e confira a conta na página da Raims antes de conceder acesso.

Autorizar um aplicativo

1. No aplicativo compatível, inicie a conexão com a Raims.
2. Conclua o login na página da Raims aberta no navegador.
3. Confira o aplicativo e defina seus acessos em Permissões.
4. Selecione Revisar para conferir o aplicativo, a conta, os ambientes, o destino de retorno e as permissões.
5. Escolha Autorizar acesso e conclua a confirmação de segurança quando solicitada.
6. Volte ao aplicativo para continuar.

O login mantém os controles da conta, incluindo MFA quando solicitado. Sua senha da Raims não precisa ser compartilhada com o aplicativo. A conexão usa OAuth e dispensa criar ou informar uma chave de API para o aplicativo.

O nome e o ícone ajudam a identificar quem solicita o acesso, mas não são um selo de verificação ou parceria. Se não reconhecer o pedido ou não quiser conceder as permissões, feche a página sem autorizar.

Permissões e ambientes

Cada operação tem uma seleção própria. Permitir criar uma cobrança não concede consulta, edição, revogação nem estorno. Os grupos organizam a matriz; não substituem a escolha individual das operações. Os perfis sugeridos preenchem uma seleção que você pode revisar antes de autorizar.

Use Saiba mais abaixo de uma operação para conferir o que ela permite, seus efeitos e os ambientes aceitos. O cadastro de cliente por CPF/CNPJ, por exemplo, pode atualizar um cliente existente com o mesmo documento.

Uma nova conexão inclui os ambientes permitidos à conta e ao seu acesso. As permissões selecionadas valem para esses ambientes. Trocar o ambiente do Dashboard não muda o alcance de uma conexão existente. Renovar a autorização também não amplia suas permissões ou seus ambientes. A edição permite restaurar acessos que já faziam parte da autorização original; outros acessos exigem uma nova conexão iniciada pelo aplicativo.

O consentimento autoriza a conexão uma vez. As operações concedidas podem ser executadas sem outra tela de aprovação para cada tarefa, sempre sujeitas às permissões atuais, aos limites e às validações da Raims.

Se os acessos ou os ambientes mudarem durante a conexão, confira novamente o resumo antes de concluir. A autorização não é repetida automaticamente.

Consultar os acessos

Abra Integração, Aplicativos autorizados para consultar os aplicativos, o responsável pela autorização, os ambientes e a validade. Cada membro pode consultar as próprias conexões. Ver aplicativos da empresa amplia a lista para as conexões do titular e da equipe. Revogar conexões da equipe também permite essa consulta e a revogação de conexões de outros funcionários, sem permitir revogar as do titular.

Para conferir as permissões de uma conexão, abra Editar permissões no menu de ações, quando disponível. Abrir o editor, pesquisar e expandir os grupos não altera os acessos. A linha do aplicativo permanece destacada enquanto o editor estiver aberto.

Consultar as conexões da empresa não permite editar ou revogar acessos de outras pessoas. As permissões de sessões e dispositivos não concedem gestão de aplicativos. Esses acessos precisam ser concedidos por um administrador autorizado, sem alteração automática das permissões dos membros existentes.

As chaves de API têm sua própria gestão em

Integração, Chaves de API.

Editar permissões

No menu da conexão, selecione Editar permissões, quando disponível. Use Pesquisar por permissão... para localizar os acessos. Escolha um dos Perfis sugeridos ou expanda os grupos para ajustar as permissões individualmente. Selecione Salvar alterações e conclua a confirmação de segurança.

Os perfis exibidos dependem dos acessos já autorizados para o aplicativo. O indicador Perfil atual acompanha a seleção, e cada grupo informa quantas permissões estão selecionadas. A busca filtra a apresentação sem alterar a seleção. Confira os grupos antes de salvar.

Cada item informa o nome e uma descrição da operação. O link Saiba mais abre sua explicação completa nesta documentação sem alterar a seleção.

Quem autorizou a conexão e o titular da conta podem editar os acessos, respeitando as permissões atuais de ambos. A permissão para consultar ou revogar conexões da equipe não libera sua edição automaticamente.

A edição permite remover e restaurar permissões da autorização original. Um acesso que deixou de estar disponível pode ser mantido ou removido, mas só pode ser restaurado quando estiver disponível novamente. A seleção não substitui as permissões atuais. Para conceder outros acessos, inicie uma nova conexão pelo aplicativo.

Os ambientes, a validade e a credencial são preservados. A remoção impede o uso da permissão nas chamadas seguintes, sem desfazer operações concluídas nem apagar dados que o aplicativo já recebeu.

Se outra alteração tornar a edição desatualizada, use Descartar alterações e recarregar e confira os acessos antes de salvar novamente. Uma falha ao salvar mantém sua seleção para que você possa conferir a mensagem e tentar de novo.

Revogar uma conexão

1. Localize o aplicativo em Aplicativos autorizados e confira o identificador em Autorizado por e os ambientes.
2. No menu de ações, selecione Revogar acesso.
3. Confira o aplicativo e o identificador de quem autorizou na confirmação e conclua a ação.

A revogação impede novas chamadas autorizadas pela conexão. Ela não desfaz operações concluídas nem apaga dados que o aplicativo externo já recebeu. Sair do Dashboard não substitui a revogação.

Para voltar a usar um aplicativo revogado, inicie uma nova conexão nele e revise as permissões novamente.

Acompanhar atividades

Abra Conta, Registro de Atividades para acompanhar autorizações aceitas ou recusadas, alterações de permissões, revogações e expirações. Uma revogação de segurança por reutilização de credencial também aparece no histórico. Os eventos automáticos são identificados como Sistema.

Cada membro consulta as próprias atividades. Ver auditoria completa permite consultar as atividades de toda a empresa. As ações registradas de um funcionário por um aplicativo preservam sua identificação no histórico. Consultar a conexão ou abrir o editor sem salvar não representa uma mudança de permissões.

Quando a conexão não puder ser concluída

• Se a solicitação expirou, já foi usada ou não está mais disponível, volte ao aplicativo e inicie outra conexão. Reabrir o mesmo link não renova o pedido.
• Se uma falha temporária impedir a consulta do pedido, aguarde as tentativas automáticas da página. Somente a consulta é repetida; autorizar continua exigindo sua confirmação.
• Se o acesso for negado, confira a conta e suas permissões atuais.
• Se o aplicativo pedir autenticação novamente, inicie a conexão e confira o consentimento apresentado pela Raims.
• Se o resultado de uma operação ficar incerto, consulte o recurso antes de solicitar outra criação.

Operações da autorização

As operações abaixo podem ser selecionadas individualmente quando estiverem disponíveis para a conta e para quem autoriza. A conexão só permite as que fazem parte do consentimento, e a edição não acrescenta operações fora da autorização original. Escolher um ambiente não dispensa essa autorização.

A descrição mantém as regras da operação pública; a conexão OAuth fornece a credencial para a chamada. Você não precisa criar ou informar uma chave de API.