> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Identity APIs

> Crie e gerencie usuários, aplicações M2M, grupos de permissão, provedores de identidade e configurações de MFA entre tenants com as Identity APIs do Access Manager.

Com as **Identity APIs**, você pode criar e gerenciar contas de usuário, configurar aplicações M2M e consultar grupos de permissão. Você também pode configurar provedores, vincular provedores a aplicações e gerenciar configurações de MFA. Em deploys multi-tenant, o bearer token determina o escopo dos resultados de usuário, grupo e aplicação. Recomenda-se que os clientes não repassem a posse do tenant pelos payloads da requisição.

## Endpoints disponíveis

***

### API de grupos

Consulte grupos de permissão predefinidos:

* [**Listar grupos**](/pt/reference/platform/access-manager/list-groups) - Recupere todos os grupos disponíveis no sistema.
* [**Obter detalhes do grupo**](/pt/reference/platform/access-manager/retrieve-group-details) - Obtenha informações detalhadas sobre um grupo específico, incluindo os usuários atribuídos.

Cada grupo mantém um conjunto predefinido de permissões. Use os IDs de grupo retornados aqui ao criar ou atualizar usuários.

### API de aplicações

Gerencie credenciais de aplicações M2M:

* [**Criar uma aplicação**](/pt/reference/platform/access-manager/create-an-application) - Registre uma nova aplicação para autenticação machine-to-machine.
* [**Listar aplicações**](/pt/reference/platform/access-manager/list-applications) - Recupere todas as aplicações registradas.
* [**Obter detalhes da aplicação**](/pt/reference/platform/access-manager/retrieve-application-details) - Obtenha informações detalhadas sobre uma aplicação específica.
* [**Excluir uma aplicação**](/pt/reference/platform/access-manager/delete-application) - Remova uma aplicação e suas credenciais.

Os nomes de aplicações M2M atuais incluem `midaz`, `plugin-fees`, `plugin-crm`, `reporter`, `plugin-br-pix-jd`, `plugin-br-pix-indirect-btg` e `plugin-br-bank-transfer`.

### API de provedores

Gerencie provedores de comunicação para entrega de MFA:

* [**Listar provedores**](/pt/reference/platform/access-manager/list-providers) - Recupere os provedores de comunicação disponíveis.
* [**Criar um provedor**](/pt/reference/platform/access-manager/create-a-provider) - Crie um novo provedor de comunicação.
* [**Obter um provedor**](/pt/reference/platform/access-manager/retrieve-a-provider) - Obtenha detalhes de um provedor específico.
* [**Atualizar um provedor**](/pt/reference/platform/access-manager/update-a-provider) - Atualize a configuração do provedor.
* [**Excluir um provedor**](/pt/reference/platform/access-manager/delete-a-provider) - Remova um provedor.

### API de provedores de aplicação

Gerencie vínculos de provedor para aplicações:

* [**Listar provedores de aplicação**](/pt/reference/platform/access-manager/list-application-providers) - Recupere os provedores vinculados a uma aplicação.
* [**Vincular provedor à aplicação**](/pt/reference/platform/access-manager/link-provider-to-application) - Vincule um provedor a uma aplicação.
* [**Atualizar vínculo de provedor da aplicação**](/pt/reference/platform/access-manager/update-application-provider-link) - Atualize um vínculo de provedor.
* [**Desvincular provedor da aplicação**](/pt/reference/platform/access-manager/unlink-provider-from-application) - Remova um vínculo de provedor de uma aplicação.
* [**Definir provedor padrão da aplicação**](/pt/reference/platform/access-manager/set-default-application-provider) - Selecione o provedor padrão para uma aplicação.

### API de usuários

Gerencie contas de usuário e credenciais:

* [**Criar um usuário**](/pt/reference/platform/access-manager/create-user) - Crie uma nova conta de usuário com atribuições de grupo.
* [**Listar usuários**](/pt/reference/platform/access-manager/list-users) - Recupere todos os usuários no sistema.
* [**Obter detalhes do usuário**](/pt/reference/platform/access-manager/retrieve-user-details) - Obtenha informações detalhadas sobre um usuário específico.
* [**Atualizar um usuário**](/pt/reference/platform/access-manager/update-user) - Modifique as informações do usuário e as associações de grupo.
* [**Excluir um usuário**](/pt/reference/platform/access-manager/delete-user) - Remova um usuário do sistema.
* [**Redefinir a senha de um usuário**](/pt/reference/platform/access-manager/reset-user-password) - Redefina a senha de um usuário (ação administrativa).
* [**Atualizar a senha de um usuário**](/pt/reference/platform/access-manager/update-user-password) - Altere a senha de um usuário com verificação da senha atual.

### API de MFA

Gerencie a configuração de MFA e as preferências de MFA do usuário:

* [**Iniciar configuração de MFA**](/pt/reference/platform/access-manager/initiate-mfa-setup) - Inicie a configuração de MFA para um usuário.
* [**Verificar código de MFA**](/pt/reference/platform/access-manager/verify-mfa-passcode) - Verifique um código de configuração de MFA.
* [**Habilitar MFA**](/pt/reference/platform/access-manager/enable-mfa) - Habilite o MFA após a verificação da configuração.
* [**Obter status do MFA**](/pt/reference/platform/access-manager/get-mfa-status) - Recupere o status atual de MFA de um usuário.
* [**Definir método de MFA preferido**](/pt/reference/platform/access-manager/set-preferred-mfa-method) - Altere o método de MFA preferido do usuário.
* [**Desabilitar MFA**](/pt/reference/platform/access-manager/disable-mfa) - Desabilite o MFA para um usuário.

## Referências relacionadas

***

* [Auth APIs](/pt/reference/platform/access-manager/am-auth-apis) - Solicite tokens, renove tokens, obtenha informações do usuário e valide permissões.
* [Lista de erros do Access Manager](/pt/reference/platform/access-manager/access-manager-error-list) - Revise os códigos de erro do Identity.
