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

# Integração do Console

> Configure sua organização, emissor e chaves de assinatura com o assistente de integração guiado.

Quando você faz login pela primeira vez em [console.truthlocks.com](https://console.truthlocks.com), um assistente guiado o conduz por tudo o que você precisa para começar a emitir atestações. O assistente detecta seu progresso automaticamente — se você sair e voltar, ele retoma de onde você parou.

## Pré-requisitos

* Uma conta Truthlocks. [Inscreva-se](https://console.truthlocks.com/auth/sign-up) se ainda não tiver uma.

## Etapas de integração

**1. Perfil do locatário**

Insira as informações básicas da sua organização:

* **Nome** — o nome de exibição da sua organização.
* **Slug** — um identificador amigável para URL usado em caminhos de API e na URL do seu console.
* **E-mail de contato** — o e-mail principal para comunicações da plataforma.
* **País** — onde sua organização está sediada (usado para residência de dados).

Esta informação é salva no registro do seu inquilino e pode ser atualizada posteriormente em **Configurações > Organização**.

**2. Organização**

Crie ou selecione uma organização dentro do seu inquilino. As organizações permitem agrupar emissores, usuários e atestações sob uma única entidade. Insira:

* **Nome da organização** — o nome legal ou operacional da organização.

Se o seu inquilino já tem uma organização, esta etapa é ignorada automaticamente.

**3. Convites da equipe**

Convide membros da equipe por e-mail e atribua-lhes uma função:

| Função | Permissões |
| :- | :- |
| Administrador | Acesso total a todos os recursos do locatário, configurações e gerenciamento de equipe |
| Membro | Criar e gerenciar emissores, emitir atestados, visualizar logs de auditoria |
| Visualizador | Acesso somente leitura a emissores, atestados e logs de auditoria |

Você pode pular esta etapa e convidar membros da equipe mais tarde na página de configurações da **Equipe**.

**4. Perfil do emissor**

Crie seu primeiro emissor — a entidade que assina atestações em nome de sua organização:

* **Nome legal** — o nome legal registrado do emissor.
* **Nome de exibição** — o nome mostrado em atestações e páginas de prova.
* **Site** — a URL do site público do emissor.
* **E-mail de contato** — usado para verificação do registro de confiança.

O emissor é criado no nível de garantia L1 (básico). Você pode solicitar um nível de garantia mais alto após o onboarding, enviando a documentação de conformidade.

Se o seu inquilino já tem um emissor configurado, esta etapa é ignorada.

**5. Chaves de assinatura**

Gere uma chave de assinatura Ed25519 para seu emissor. Esta chave é usada para assinar criptograficamente cada atestação que seu emissor cria.

Clique em **Gerar chaves** e o assistente criará um par de chaves automaticamente. A chave pública é registrada na plataforma Truthlocks, enquanto a chave privada é armazenada com segurança no serviço de assinatura.

> [!WARNING]
>
> As chaves de assinatura não podem ser excluídas após geradas. Se uma chave for comprometida, use o endpoint [comprometimento de chave](https://docs.truthlocks.com/pt/api-reference/issuers/keys-compromise.md) para marcá-la como comprometida e rotacionar para uma nova chave.

Se o seu emissor já possui chaves de assinatura, esta etapa mostra os detalhes da chave existente e permite que você prossiga.

**6. Cunhagem de teste**

Verifique sua configuração cunhando um atestado de teste. O assistente fornece uma lista pesquisável de esquemas de atestado organizados em categorias:

* **Identidade** — verificação de e-mail, KYC, documento de identidade governamental
* **Emprego** — verificação de emprego, verificação de antecedentes, renda
* **Educação** — diploma, histórico escolar, matrícula
* **Saúde** — licença, imunização, seguro
* **Conformidade** — SOC2, ISO 27001, GDPR
* **Financeiro** — acreditação, verificação bancária, crédito
* **Habilidades** — certificação, avaliação, portfólio
* **Cadeia de suprimentos** — origem, qualidade, envio
* **Outros** — reivindicações personalizadas

Selecione um esquema, insira um endereço de e-mail do destinatário e clique em **Mint test attestation**. O assistente chama o endpoint de atestado de cunhagem e mostra o ID do atestado resultante em caso de sucesso.

> [!TIP]
>
> A atestação de teste é uma atestação real registrada no log de transparência. Você pode verificá-la imediatamente usando o [endpoint de verificação](https://docs.truthlocks.com/pt/api-reference/verify.md).

**7. Entrar em produção**

A etapa final mostra uma lista de pré-requisitos:

* Perfil do inquilino concluído
* Organização criada
* Perfil do emissor configurado
* Pipeline verificado (atestação de teste cunhada)

Quando todos os itens estiverem marcados, clique em **Ativar e ir para o console** para concluir a integração e acessar o painel completo do console.

## Após a integração

Assim que o assistente estiver concluído, você aterrissa no painel da consola do inquilino.

### Painel do tenant

O painel exibe quatro cartões de estatísticas na parte superior:

| Cartão | O que ele mostra |
| :- | :- |
| **Emissores ativos** | Emissores confiáveis do total configurado |
| **Atestados** | Total de atestados com contagem de ativos ou revogados |
| **Atestados ativos** | Atestados atualmente válidos |
| **Funções configuradas** | Funções do sistema e personalizadas |

Quando você tem pelo menos uma atestação, três gráficos de insights aparecem abaixo dos cartões de estatísticas:

* **Status do atestado** — um gráfico de rosca detalhando atestados ativos, revogados e outros.
* **Cobertura do emissor** — um gráfico de barras comparando emissores ativos versus emissores totais.
* **Saúde da plataforma** — um medidor radial mostrando a porcentagem de atestações que estão atualmente ativas.

Se sua organização tiver uma solicitação de conformidade pendente, um banner aparecerá na parte superior do painel com os requisitos e o prazo. Clique em **Revisar e Enviar** para ir para a página de configurações de conformidade.

Uma seção de **Ações Rápidas** oferece atalhos para gerenciar emissores, visualizar atestados e gerenciar chaves de API.

No painel, você também pode:

* Cunhar atestações em escala através da UI do console ou [API](https://docs.truthlocks.com/pt/api-reference/attestations/mint.md).
* Configure [webhooks](https://docs.truthlocks.com/pt/guides/webhooks.md) para receber notificações de eventos em tempo real.
* Configure [políticas de governança](https://docs.truthlocks.com/pt/api-reference/governance/create-request.md) para fluxos de trabalho de aprovação multipartidários.
* Gerenciar [chaves de API](https://docs.truthlocks.com/pt/api-reference/api-keys/create.md) para acesso programático.

## Modo escuro

O console suporta o modo escuro em todas as páginas. Você pode alternar entre três modos de aparência na barra superior:

| Modo | Comportamento |
| :- | :- |
| **Claro** | Fundos claros com texto escuro |
| **Escuro** | Fundos escuros com texto claro, otimizado para ambientes com pouca luz |
| **Sistema** | Corresponde automaticamente à preferência de aparência do seu sistema operacional |

Clique no ícone de alternância de tema na barra superior para alternar entre os modos — sol (claro), lua (escuro) e monitor (sistema). Você também pode alternar os temas no menu de perfil — clique no seu avatar no canto superior direito para abrir um menu suspenso com botões claro, escuro e sistema. Sua preferência é salva localmente e persiste entre as sessões.

> [!TIP]
>
> O console assume o modo escuro por padrão no primeiro carregamento. O portal de verificação tem sua própria configuração de tema independente — consulte o [guia do portal do consumidor](https://docs.truthlocks.com/pt/guides/consumer-portal.md#dark-mode).

## Navegação do Console

O console usa uma barra de navegação recolhível no lado esquerdo da tela:

* **Estado recolhido** — uma barra estreita mostrando apenas ícones. Passe o mouse sobre ela para expandir e revelar os rótulos.
* **Estado expandido** — a barra lateral completa com ícones e nomes de página. Clique no ícone de alfinete para mantê-la aberta.
* **Celular** — em telas menores, a navegação é acessível através de um menu hambúrguer que abre uma gaveta deslizante.

A barra organiza as páginas em grupos — seu painel, emissores, atestações, verificação, chaves de API, logs de auditoria e configurações. A página ativa é destacada e cada grupo se recolhe independentemente.

A barra superior exibe os breadcrumbs para sua localização atual, um atalho de pesquisa, o [seletor de ambiente](https://docs.truthlocks.com/pt/environments.md#switching-environments), o alternador de tema e um menu de perfil.

### Paleta de pesquisa

Pressione `Cmd+K` (macOS) ou `Ctrl+K` (Windows/Linux) para abrir a paleta de pesquisa, ou clique na barra de pesquisa na barra superior. A paleta permite que você pule para qualquer página no console sem navegar pelos menus.

Os resultados incluem todas as páginas disponíveis para sua função — painel, emissores, atestados, pacotes de verificação, logs de auditoria, configurações e muito mais. Comece a digitar para filtrar a lista e pressione **Enter** para navegar até a página selecionada.

> [!TIP]
>
> O atalho de pesquisa funciona de qualquer lugar no console. É a maneira mais rápida de alternar entre as páginas quando você já sabe para onde quer ir.

### Menu de perfil

Clique no seu avatar no canto superior direito para abrir o menu de perfil. O avatar exibe a primeira letra do nome da sua organização em um fundo gradiente.

O menu suspenso é organizado em três seções:

* **Informações da conta** — nome da sua organização e endereço de e-mail.
* **Configurações da conta** — abre a página de configurações de segurança onde você pode gerenciar sua senha, sessões e preferências de MFA.
* **Seletor de tema** — três botões em linha para temas claro, escuro e do sistema. O tema ativo é destacado. Esta é uma alternativa ao ícone de alternância de tema na barra superior.
* **Sair** — desconecta você do console. Uma caixa de diálogo de confirmação aparece antes que a sessão termine para evitar saídas acidentais.

## Anúncios

A página **Anúncios** exibe mensagens de toda a plataforma da Truthlocks — incluindo atualizações do sistema, alertas de segurança e notificações operacionais. Acesse-a na barra lateral em **Anúncios**.

Cada anúncio tem um nível de prioridade:

| Prioridade | Quando é usado |
| :- | :- |
| **Normal** | Atualizações gerais da plataforma e mensagens informativas |
| **Urgente** | Mudanças sensíveis ao tempo que podem afetar seus fluxos de trabalho |
| **Crítico** | Alertas de segurança ou interrupções de serviço que exigem atenção imediata |

A página de anúncios usa um layout mestre-detalhe:

* **Painel esquerdo** — uma lista pesquisável e filtrável de todos os anúncios. Filtre por **Todos**, **Não lidos** ou **Importantes** (somente urgentes e críticos). Mensagens não lidas mostram um indicador de ponto azul.
* **Painel direito** — o conteúdo completo do anúncio selecionado, incluindo o selo de prioridade, carimbo de data/hora e detalhes do remetente.

Clique em um anúncio para visualizá-lo e marcá-lo automaticamente como lido. Use o botão **Marcar tudo como lido** para dispensar todos os indicadores não lidos de uma vez.

## Relacionado

> [card] [Início rápido](https://docs.truthlocks.com/quickstart.md)
>
> Emita sua primeira atestação via API em menos de 5 minutos.

> [card] [Conceitos centrais](https://docs.truthlocks.com/concepts.md)
>
> Entenda inquilinos, emissores, atestados e verificação.

> [card] [Ambientes](https://docs.truthlocks.com/environments.md)
>
> Configuração do ambiente de sandbox vs. produção.

> [card] [RBAC](https://docs.truthlocks.com/security/rbac.md)
>
> Controle de acesso baseado em função e gerenciamento de permissões.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.