> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/o-seu-espaco-de-trabalho/settings/authentications.md).

# Autenticações de Integração

Teste ligações de integração, acompanhe a expiração de credenciais e use credenciais em Workflows.

Muitas das integrações nativas da AirOps (Asana, HubSpot, Webflow, Shopify, entre outras) exigem autenticação antes de poderem ser usadas nas etapas de um fluxo de trabalho. Depois de autenticar, pode optar por **expor** essas credenciais para que possam ser referenciadas diretamente em modelos Liquid e etapas de código. Isto é útil quando pretende chamar uma API que a etapa nativa não abrange ou interpolar um token num pedido.

## Dê um nome a uma autenticação

Ao adicionar uma autenticação em **Definições → Integrações**, pode introduzir um nome personalizado para distinguir contas ou ambientes. Deixe o nome em branco para usar o nome gerado. Esta opção também se aplica a ligações OAuth.

## Testar uma ligação

Use **Testar ligação** em **Definições → Integrações** para verificar as integrações suportadas antes de as usar nos fluxos de trabalho. Pode testar novas credenciais durante a configuração ou usar o menu da autenticação guardada para testar uma ligação existente. Se já houver um resultado, selecione **Ver resultados do teste** e use **Testar novamente** para voltar a verificar.

A coluna **Última verificação da ligação** descreve o teste mais recente. **Teste indisponível** significa que a AirOps não disponibiliza testes para essa integração; **Não testada** significa que não foi executado nenhum teste. Nenhuma das etiquetas significa que a autenticação está desligada.

Consulte os resultados guardados e as verificações individuais:

| Estado                      | Significado                                                                                     |
| --------------------------- | ----------------------------------------------------------------------------------------------- |
| **Ligada**                  | As verificações da ligação foram aprovadas.                                                     |
| **Verificada parcialmente** | Algumas verificações foram aprovadas, mas não foi possível verificar as restantes.              |
| **Não verificada**          | Não foi possível determinar, através das verificações, se a ligação funciona.                   |
| **Acesso limitado**         | Consulte as verificações de acesso que falharam e as permissões necessárias para a integração.  |
| **Falha na ligação**        | Consulte o erro, corrija as credenciais ou a configuração e teste novamente.                    |
| **Estado indisponível**     | A AirOps não consegue apresentar um resultado de verificação fiável. Teste novamente a ligação. |

Um resultado individual **Não verificada** não significa necessariamente que as credenciais estejam erradas. Algumas ações não podem ser testadas sem criar, editar ou eliminar conteúdo. Verifique essas ações antes de confiar nelas num fluxo de trabalho.

Para uma nova ligação, escolha **Guardar integração** depois de analisar os resultados. **Guardar mesmo assim** permite guardar credenciais com um resultado impeditivo; não resolve as verificações que falharam.

Os testes de ligação do Contentful estão disponíveis para autenticações com acesso total e incluem o ID do espaço configurado.

No caso do OAuth do Semrush, **Testar ligação** verifica a autenticação do token e o acesso ao servidor sem consumir unidades da API de relatórios. Uma verificação de autenticação aprovada não confirma as permissões de relatórios nem os créditos de relatórios disponíveis. Consulte a nota separada sobre acesso a relatórios antes de executar um fluxo de trabalho.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-781014a050068c906c2e9666c769859440c30986%2Fauthentications-01-integrations-list.png?alt=media" alt="Settings Integrations list with named authentications, a connection test result, an expiration badge, and Expose credentials"><figcaption><p>Teste ligações, acompanhe as expirações e exponha credenciais nas Integrações.</p></figcaption></figure>

## Acompanhar a expiração das credenciais

Nas ligações compatíveis com token ou autenticação básica, defina uma **Data de expiração** opcional ao criar ou editar credenciais. Os administradores podem definir, atualizar ou remover a data, e a lista de autenticações apresenta o valor configurado. As ligações OAuth e geridas pelo Pipedream não disponibilizam este campo.

Use a data para registar quando é necessário renovar a credencial emitida pelo fornecedor. Defini-la não renova nem prolonga a validade da credencial. A AirOps envia **Caixa de entrada** avisos 30 dias antes da expiração, 14 dias antes da expiração e quando as credenciais expirarem. Estas notificações incluem uma ligação para **Integrações**, onde pode atualizar as credenciais e a data.

## Ativar a disponibilização

1. Aceda a **Definições > Integrações**.
2. Localize a autenticação que pretende disponibilizar.
3. Ative **Disponibilizar credenciais** nessa linha.

A opção está desativada por predefinição. As credenciais só ficam disponíveis para os fluxos de trabalho se optar explicitamente por disponibilizá-las.

## Referenciar em fluxos de trabalho

Depois de disponibilizadas, as credenciais podem ser acedidas através da variável `authentications` , organizada primeiro pelo nome do fornecedor e, em seguida, pelo nome de apresentação da autenticação.

### Modelo Liquid

```
{{ authentications['asana']['Prod'].token }}
```

### Passo de código JavaScript

```javascript
const auth = authentications.asana["Prod"];
const token = auth.token;
```

### Passo de código Python

```python
auth = authentications["asana"]["Prod"]
token = auth["token"]
```

O seletor de variáveis do construtor de fluxos de trabalho apresenta as autenticações disponibilizadas na categoria "Autenticações de integrações". Ao clicar numa entrada, é inserido o caminho correto para o modo do editor que está a utilizar.

## O que está disponível

Os campos exatos dependem do tipo de autenticação. Nas integrações OAuth, terá normalmente `token`, `refresh_token`, e `expires_at`. Nas integrações com chave de API, terá os campos utilizados pela integração (normalmente, `api_key`).

## Desativar a disponibilização

Desative a opção. As referências às credenciais que deixaram de estar disponíveis passam a ter valores vazios; se um fluxo de trabalho dependia dessas credenciais, as chamadas seguintes podem falhar. Volte a ativar a opção para as disponibilizar novamente.

## Segurança

As credenciais são automaticamente ocultadas como `*****` nos registos de rastreio e nas mensagens de erro dos passos, para que a depuração de erros que mencionem um token não exponha o seu valor no histórico de execução.

Os resultados dos passos não são ocultados. Se um passo de código devolver diretamente um valor de credencial (por exemplo, `return token`), o valor aparecerá no rastreio da execução. Tenha cuidado para não incluir credenciais nos resultados dos passos.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/o-seu-espaco-de-trabalho/settings/authentications.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
