> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-docs/caf-product-guides-pt-br/guia-do-usuario/smart-auth/getting-started.md).

# Primeiros passos

## **Criação de conta**

Antes de tudo, você precisará estar cadastrado no Smart Auth. Se você ainda não tem uma conta, por favor [cadastre-se aqui](https://identity.combateafraude.com/signup).

## **Identidades**

As identidades são usadas para autenticar seus usuários.

Acesse a aba "Identidades" e depois vá para "Criar identidade".

### **Dados necessários para criar uma identidade**

| Campo          | Obrigatório |
| -------------- | ----------- |
| **`PersonId`** | Sim         |
| **`Nome`**     | Sim         |
| **`Selfie`**   | Sim         |
| **`Telefone`** | Não         |
| **`E-mail`**   | Não         |

{% hint style="info" %}
Você deve informar o telefone com código do país e da região, DDI+DDD+NÚMERO (5511999999999).
{% endhint %}

### **Criar uma identidade manualmente**

Na aba de criação manual, preencha os dados da identidade desejada e envie uma selfie. Para concluir, clique em "Registrar identidade".

### **Criar identidades via API**

Você também pode criar identidades via API, permitindo uma experiência mais fluida e integrada no seu próprio fluxo de usuários. Essa abordagem permite automatizar a criação de identidades e integrá-la totalmente aos seus sistemas.\
Para mais detalhes, consulte a [documentação da API de Identidades](https://docs.caf.io/caf-api/smart-auth-api/available-resources/identity).

## **Políticas de acesso**

As políticas de acesso definem como os usuários serão autenticados. Os contextos são as informações que serão coletadas para determinar se o usuário está acessando o sistema a partir de um contexto conhecido. Os métodos de reautenticação, por outro lado, são as etapas pelas quais o usuário terá que passar para comprovar sua identidade caso o contexto dele não seja conhecido.

Para criar uma política, vá para a aba "Ferramentas", selecione "Políticas de autenticação" e clique em "Criar política".

### **Dados necessários para criar uma política de acesso**

| Campo                          | Obrigatório |
| ------------------------------ | ----------- |
| **`Identificador`**            | Sim         |
| **`Nome`**                     | Sim         |
| **`Contextos`**                | Sim         |
| **`Método de reautenticação`** | Sim         |

### **Identificador**

É o ID exclusivo da política. Ele é usado ao invocar o SDK do Smart Auth.

### **Contextos**

| Contexto          | Descrição                                                    |
| ----------------- | ------------------------------------------------------------ |
| **`Dispositivo`** | Verifica se o dispositivo usado pelo usuário é conhecido     |
| **`Localização`** | Verifica se a localização de acesso do usuário é conhecida   |
| **`Rede`**        | Verifica se as informações de rede do usuário são conhecidas |

### **Métodos de reautenticação**

| Método                    | Descrição                                                                                                       |
| ------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **`Autenticação facial`** | Tira uma foto do usuário que está acessando o sistema e a compara com a selfie cadastrada para a identidade     |
| **`E-mail`**              | Envia um código para o endereço de e-mail cadastrado para a identidade e usa esse código para validar o usuário |
| **`SMS`**                 | Envia um código via SMS para o telefone cadastrado para a identidade e usa esse código para validar o usuário   |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.caf.io/caf-docs/caf-product-guides-pt-br/guia-do-usuario/smart-auth/getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.