> 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-sdk/caf-sdk-pt-br/flutter/sdks-response.md).

# Resposta dos SDKs

| InstanceOf               | Descrição                                                                                                       | Exemplo                                                                                                                                                 | SDKs presentes                                                                               |
| ------------------------ | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **`InvalidTokenReason`** | O token informado não é válido para o produto correspondente                                                    | Parametrize "test123" como token no builder do SDK                                                                                                      | <p>DocumentDetector</p><p>PassiveFaceLiveness</p><p>FaceAuthenticator</p>                    |
| **`PermissionReason`**   | Falta alguma permissão obrigatória para executar o SDK                                                          | Iniciar o DocumentDetector sem permissão de câmera concedida                                                                                            | <p>DocumentDetector</p><p>PassiveFaceLiveness</p><p>FaceAuthenticator</p><p>AddressCheck</p> |
| **`AvailabilityReason`** | O SDK ainda não está disponível para uso. A variável `SDKFailure.getMessage()` contém instruções para o usuário | O armazenamento interno do dispositivo está cheio ao instalar o app, e o template de detecção facial não pode ser instalado junto                       | <p>PassiveFaceLiveness</p><p>FaceAuthenticator</p>                                           |
| **`NetworkReason`**      | Falha na conexão com a internet                                                                                 | O usuário estava sem internet durante o facematch no FaceAuthenticator                                                                                  | <p>DocumentDetector</p><p>PassiveFaceLiveness</p><p>FaceAuthenticator</p><p>AddressCheck</p> |
| **`ServerReason`**       | Quando uma requisição do SDK recebe um código de status de falha                                                | Em teoria, isso não deveria acontecer. Se você vir algo assim, nos avise!                                                                               | <p>DocumentDetector</p><p>PassiveFaceLiveness</p><p>FaceAuthenticator</p><p>AddressCheck</p> |
| **`SecurityReason`**     | Quando o SDK não pode ser iniciado por um motivo de segurança                                                   | Quando [Provedor de Segurança do Google](https://developer.android.com/training/articles/security-gms-provider) não está atualizando                    | <p>DocumentDetector</p><p>PassiveFaceLiveness</p><p>FaceAuthenticator</p>                    |
| **`StorageReason`**      | Não há espaço no armazenamento interno do dispositivo do usuário                                                | Quando não há espaço no armazenamento interno ao capturar a foto do documento                                                                           | <p>DocumentDetector</p><p>PassiveFaceLiveness</p><p>FaceAuthenticator</p>                    |
| **`LibraryReason`**      | Quando uma biblioteca interna do SDK não pode ser iniciada                                                      | Esquecer de definir oCompress [configuração](https://docs.caf.io/sdks/android/getting-started#project-settings) levará a essa falha no DocumentDetector | DocumentDetector                                                                             |
| **`InvalidFaceReason`**  | Não há registro facial para o peopleId informado                                                                | Quando o usuário se autentica com um peopleId que não possui registro facial                                                                            | FaceAuthenticator                                                                            |

## **A Segurança retorna** <a href="#fcxzj6hlx7r4" id="fcxzj6hlx7r4"></a>

Estamos constantemente tomando ações para tornar o produto cada vez mais seguro, mitigando muitos ataques observados nos processos de captura e, consequentemente, reduzindo o máximo possível as fraudes de identidade. Os erros descritos aqui são retornados em `message` campo da `SecurityReason` classe.

### **Error 100** <a href="#id-8zs8bu8ne375" id="id-8zs8bu8ne375"></a>

Representa o bloqueio de dispositivos emulados pelo SDK.

O uso de emuladores é muito comum atualmente por fraudadores, devido à possibilidade de acessar qualquer dispositivo existente, abrindo um enorme leque de possibilidades para novas fraudes. Por isso, por padrão, os SDKs realizam esse bloqueio.

Se você quiser desativar essa validação, use o `emulatorSettings` parâmetro no SDK Builder.

### Error 200 <a href="#gupl3vpgiuj" id="gupl3vpgiuj"></a>

Representa o bloqueio de dispositivos com privilégios de root pelo SDK.

O uso de dispositivos com root é hoje o principal meio de fraude, devido à possibilidade de acessar um dispositivo com privilégios extras, permitindo que o fraudador acesse propriedades ocultas, além da possibilidade de modificar e contornar todo o sistema de segurança por trás dos SDKs. Por isso, por padrão, os SDKs realizam esse bloqueio.

Se você quiser desativar essa validação, use o `rootSettings` parâmetro no SDK Builder.

### Error 300 <a href="#b31f4ihwtfvc" id="b31f4ihwtfvc"></a>

Representa o bloqueio de dispositivos com o modo de desenvolvedor ativo.

Usar dispositivos com o modo de desenvolvedor ativo permite que o usuário acesse configurações exclusivas de desenvolvimento, como a capacidade de depurar aplicativos usando cabos USB. Por isso, por padrão, os SDKs realizam esse bloqueio.

Se você quiser desativar essa validação, use o `useDeveloperMode` parâmetro no SDK Builder.

### Error 400 <a href="#id-9gaqr4lsttkb" id="id-9gaqr4lsttkb"></a>

Representa o bloqueio de dispositivos com o Android Debug Bridge ativado.

O comando ADB facilita uma variedade de ações no dispositivo, como instalar e depurar apps, e fornece acesso a um shell Unix. Por isso, por padrão, os SDKs realizam esse bloqueio.

Se você quiser desativar essa validação, use o `useAdb` parâmetro no SDK Builder.

### Error 500 <a href="#mlxu694suxt5" id="mlxu694suxt5"></a>

Representa o bloqueio de dispositivos com o modo de depuração ativado.

Usar dispositivos com o modo de depuração ativado permite que o usuário depure aplicativos usando cabos USB, permitindo que ele entenda e teste diferentes maneiras de contornar o fluxo do SDK. Por isso, por padrão, os SDKs realizam esse bloqueio.

Se você quiser desativar essa validação, use o `useDebug` parâmetro no SDK Builder.


---

# 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-sdk/caf-sdk-pt-br/flutter/sdks-response.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.