> For the complete documentation index, see [llms.txt](https://docs.vaultid.com.br/workspace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vaultid.com.br/workspace/wings/como-funciona.md).

# Como funciona

**Autenticação de usuário**&#x20;

O usuário é identificado por CPF e autenticado por meio de um código OTP obtido no aplicativo BirdID.&#x20;

Após a autenticação, a aplicação recebe um token de acesso e as informações de contexto disponíveis, que podem incluir as corporações e os papéis associados ao usuário.&#x20;

O tempo de vida solicitado para esse token não pode ultrapassar sete dias.&#x20;

**Contexto corporativo**&#x20;

Quando o usuário possui acesso a uma ou mais corporações, a aplicação deve selecionar qual delas será utilizada como contexto das operações corporativas.&#x20;

As consultas e alterações subsequentes são realizadas considerando a corporação selecionada.&#x20;

**Autenticação de aplicação externa**&#x20;

Aplicações externas utilizam credenciais próprias, identificadas por client\_id e client\_secret, para obter um token de acesso.&#x20;

Esse token permite realizar as operações autorizadas de gestão de usuários de varejo.&#x20;

**Gestão de usuários e créditos**&#x20;

As operações corporativas permitem consultar e atualizar informações de usuários, individualmente ou em lote.&#x20;

Para usuários de varejo, as operações disponibilizam consultas de dados e créditos, além da possibilidade de alteração do tipo de usuário entre normal e trial.
