> 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 e outras) exigem que você se autentique antes de poder usá-las nas etapas do workflow. Depois de autenticado, você pode optar por **expor** essas credenciais para que possam ser referenciadas diretamente a partir de modelos Liquid e etapas de código. Isso é útil quando você quer chamar uma API que a etapa nativa não cobre, ou interpolar um token em uma solicitação. ## Nomeie uma autenticação Ao adicionar uma autenticação em **Definições → Integrações**, você pode inserir um nome personalizado para distinguir contas ou ambientes. Deixe o nome em branco para usar o nome gerado. Essa opção também se aplica a conexões OAuth. ## Testar uma ligação Use **Testar ligação** em **Definições → Integrações** para verificar integrações compatíveis antes de usá-las em Workflows. Você pode testar novas credenciais durante a configuração ou usar o menu da autenticação salva para testar uma conexão existente. Se já existir um resultado, selecione **Ver resultados do teste** e use **Testar novamente** para verificar novamente. Revise o **Estado da conexão** e as verificações individuais: | Status | Significado | | --------------------------- | ------------------------------------------------------------------------------------------ | | **Connected** | As verificações da conexão foram aprovadas. | | **Verificado parcialmente** | Algumas verificações passaram, mas outras não puderam ser verificadas. | | **Não verificado** | As verificações não conseguiram estabelecer se a conexão funciona. | | **Acesso limitado** | Revise as verificações de acesso com falha e as permissões necessárias para a integração. | | **Falha na conexão** | Revise o erro, corrija as credenciais ou a configuração e teste novamente. | | **Status indisponível** | A AirOps não pode exibir um resultado de verificação confiável. Teste a conexão novamente. | Um resultado individual **Não verificado** resultado não significa necessariamente que as credenciais estejam erradas. Algumas ações não podem ser testadas sem criar, editar ou excluir conteúdo. Revise essas ações antes de confiar nelas em um Workflow. Para uma nova conexão, escolha **Guardar integração** após revisar os resultados. **Salvar mesmo assim** permite salvar credenciais com um resultado bloqueante; isso não resolve as verificações com falha. O teste de conexão do Contentful está disponível para autenticações com acesso total e inclui o Space ID configurado. ## Acompanhar a expiração das credenciais Para conexões compatíveis com token ou autenticação básica, defina um opcional **Data de expiração** ao criar ou editar credenciais. Os administradores podem definir, atualizar ou limpar a data, e a lista de autenticações mostra o valor configurado. Conexões OAuth e gerenciadas pelo Pipedream não exibem este campo. Use a data para registrar quando a credencial emitida pelo provedor precisa ser renovada. Defini-la não renova nem estende a 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. Essas notificações direcionam de volta para **Integrações**, onde você pode atualizar as credenciais e a data. ## Ativando a exposição 1. Navegue até **Definições > Integrações**. 2. Encontre a autenticação que deseja expor. 3. Alternar **Expor credenciais** nessa linha. O alternador vem desativado por padrão. As credenciais só ficam disponíveis para workflows quando você opta explicitamente por isso. ## Referenciando em workflows Depois de expostas, as credenciais ficam acessíveis por meio da `authentications` variável, indexada pelo nome do provedor e depois pelo nome de exibição da autenticação. ### Modelo Liquid ``` {{ authentications['asana']['Prod'].token }} ``` ### Etapa de código JavaScript ```javascript const auth = authentications.asana["Prod"]; const token = auth.token; ``` ### Etapa de código Python ```python auth = authentications["asana"]["Prod"] token = auth["token"] ``` O seletor de variáveis no construtor de workflows lista as autenticações expostas na categoria "Integration Authentications". Clicar em uma entrada insere o caminho correto para o modo de editor em que você está. ## O que está disponível Os campos exatos dependem do tipo de autenticação. Para integrações OAuth, você normalmente terá `token`, `refresh_token`, e `expires_at`. Para integrações com API key, você terá o campo que a integração usar (comumente `api_key`). ## Desativando a exposição Desative o interruptor. Os workflows que referenciam as credenciais agora não expostas serão resolvidos para valores vazios; se um workflow dependia dessas credenciais, chamadas subsequentes podem falhar. Reative para restaurar. ## Segurança As credenciais são automaticamente mascaradas como `*****` em logs de rastreamento e mensagens de erro da etapa, de modo que depurar erros que mencionem um token não vazará o valor para o histórico de execução. As saídas das etapas não são mascaradas. Se uma etapa de código retornar um valor de credencial diretamente (por exemplo, `return token`), o valor aparecerá no rastreamento de execução. Tenha cuidado para não emitir credenciais nas saídas das etapas. --- # 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=&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.