> ## Documentation Index > Fetch the complete documentation index at: https://docs.strattum.ai/llms.txt > Use this file to discover all available pages before exploring further. # Disponibilize o Anywhere > Prepare os serviços, o Gateway e a autenticação antes de entregar o Anywhere à equipe. Este guia é para o responsável técnico pela implantação. A entrega do Anywhere inclui o ambiente da plataforma, o Gateway e o canal de instalação da extensão. O Gateway e o acesso à conta pertencem ao produto Anywhere. As aplicações de origem são disponibilizadas por integrações próprias; o Zendesk é a primeira implementação disponível. Para a instalação no navegador, encaminhe ao usuário [Instale e mantenha o Anywhere](https://docs.strattum.ai/applications/anywhere/installation.md). ## Componentes necessários | Componente | Responsabilidade | | - | - | | Extensão do Chrome | Painel, leitura do contexto e ações disponibilizadas pela integração | | Gateway | Autenticação da extensão, verificação de acesso e encaminhamento das operações | | Identity | Login Strattum, renovação de credenciais e vínculos individuais com fontes | | Applications Runtime | Execução da IA e histórico das conversas | | Catalog, Memory e Skills | Descoberta das aplicações e consultas que sustentam as fichas conforme a ontologia do cliente | | Fontes sincronizadas | Registros, conteúdos e relacionamentos das aplicações disponibilizadas | | PostgreSQL | Dados de operação dos serviços e preferências do usuário | O serviço de IA precisa estar configurado com o modelo e as ferramentas do ambiente. A extensão recebe apenas o endereço do Gateway para sua conexão inicial. ## Prepare a instalação da plataforma Use a instalação da plataforma adequada ao ambiente. No **Starter**, o serviço `strattum-anywhere-gateway` é publicado por HTTPS no endereço `https://anywhere.`. 1. Configure o DNS desse endereço para a instalação. 2. Confira o certificado HTTPS e o acesso pela rede dos usuários. 3. Prepare Identity, Applications Runtime e banco de dados. 4. Disponibilize as fontes e os acessos descritos em [Gerencie acessos e fontes](https://docs.strattum.ai/admin/anywhere/access.md). As [instruções de instalação da plataforma](https://docs.strattum.ai/getting-started/installation-aws.md) cobrem o provisionamento inicial. As etapas seguintes tratam da configuração do Anywhere nesse ambiente. ## Ative os serviços no Starter No Starter, **`ANYWHERE_ENABLED`** é a opção técnica de ativação do Gateway. Ela começa em `false` nos valores padrão do mecanismo de implantação. | Valor | Efeito | | - | - | | `true` | Inclui o Gateway e o serviço de IA na seleção de serviços da implantação | | `false` | Não inclui o perfil do Gateway por essa opção | O valor `true` exige o identificador e os endereços de retorno do cliente de autenticação preenchidos. A configuração deve entrar na fonte de configuração da implantação, para ser preservada nas atualizações. ### Exemplo de endereços O exemplo usa o domínio fictício `empresa.example`. Substitua-o pelo domínio da instalação. ```dotenv theme={null} ANYWHERE_ENABLED=true GATEWAY_PUBLIC_URL=https://anywhere.empresa.example OAUTH_ANYWHERE_CLIENT_ID=strattum-anywhere OAUTH_ANYWHERE_REDIRECT_URIS=https://anywhere.empresa.example/v1/auth/callback,https://anywhere.empresa.example/v1/slack/connect/identity/callback,https://anywhere.empresa.example/v1/slack/connections/identity/callback ANYWHERE_OIDC_REDIRECT_URI=https://anywhere.empresa.example/v1/auth/callback ANYWHERE_LINK_RETURN_URL=https://anywhere.empresa.example/v1/links/return ``` `OAUTH_ANYWHERE_REDIRECT_URIS` é uma lista compartilhada pelo Anywhere e pelo App do Slack. O primeiro endereço é o retorno do Anywhere; os dois seguintes são usados pelo Slack na conexão da conta. Ao editar a lista, preserve os endereços já registrados. Substituir a lista apenas pelo retorno do Anywhere interrompe a conexão de conta pelo Slack. No Starter gerenciado por Terraform, os retornos do Slack são acrescentados automaticamente. ## Configure a autenticação O Gateway usa um cliente próprio no Identity. O endereço de retorno precisa corresponder exatamente a um endereço registrado, incluindo protocolo, domínio e caminho. | Configuração | Onde | Regra | | - | - | - | | `OAUTH_ANYWHERE_CLIENT_ID` | Identity / configuração da implantação | Identificador próprio do cliente, como `strattum-anywhere` | | `OAUTH_ANYWHERE_REDIRECT_URIS` | Identity / configuração da implantação | Lista de endereços de retorno exatos; use `/v1/auth/callback` no Gateway | | `ANYWHERE_OIDC_CLIENT_ID` | Gateway | Mesmo identificador registrado no Identity; o Starter o recebe do campo anterior | | `ANYWHERE_OIDC_REDIRECT_URI` | Gateway | Um dos endereços registrados no Identity | | `ANYWHERE_OIDC_CLIENT_SECRET` | Gateway, quando configurado diretamente | Vazio para esse cliente público, que usa proteção por código de verificação | | `ANYWHERE_OIDC_ISSUER` | Gateway | Endereço de descoberta publicado pelo Identity; no Starter, deriva de `OAUTH_PUBLIC_URL` | | `ANYWHERE_JWKS_URL` | Gateway | Endereço das chaves públicas usado para conferir credenciais | | `ANYWHERE_JWT_ISSUER` / `ANYWHERE_JWT_AUDIENCE` | Gateway | Mesmos valores de emissor e destinatário utilizados pela plataforma | | `ANYWHERE_LINK_RETURN_URL` | Identity / implantação | Retorno da vinculação individual das fontes para o Gateway | O endereço público de descoberta e o emissor gravado na credencial são configurações distintas. Copie os valores da instalação; preserve a correspondência entre Identity, Gateway e serviço de IA. Registre o cliente pelos campos próprios `OAUTH_ANYWHERE_*` do Identity. O cadastro genérico de um cliente com o mesmo nome não substitui essa configuração. ## Confira as conexões entre serviços | Configuração do Gateway | Obrigatoriedade | Finalidade | | - | - | - | | `ANYWHERE_RUNTIME_URL` | Obrigatória | Endereço interno do serviço de IA para geração e conversa | | `ANYWHERE_PG_DSN` | Necessária para os dados de operação | Conexão do Gateway ao banco com seu usuário dedicado | | `ANYWHERE_IDENTITY_API_URL` | Necessária para vínculos e descoberta de acesso | Consulta das fontes disponíveis para cada pessoa | | `ANYWHERE_SERVICE_API_KEY` | Necessária nas chamadas de serviço protegidas | Credencial de serviço mantida no ambiente do Gateway | | `ANYWHERE_CATALOG_API_URL` | Necessária para descoberta pela plataforma | Consulta das aplicações e contas disponíveis | | `ANYWHERE_MEMORY_API_URL` e `ANYWHERE_SKILLS_API_URL` | Necessárias para as fichas contextuais | Consultas estruturadas conforme a ontologia e a aplicação de origem | | `ANYWHERE_ENVIRONMENT_ID` | Opcional no serviço | Identificador do ambiente | | `ANYWHERE_ENVIRONMENT_NAME` | Opcional no serviço | Nome apresentado ao usuário na conexão | Os endereços internos são configurações dos serviços. Para o usuário, entregue o endereço público HTTPS do Gateway. Ao configurar o serviço diretamente, mantenha credenciais no mecanismo de segredos do ambiente. Os campos opcionais do serviço só entram no processo quando a definição de implantação os encaminha. ## Aplique e confira a implantação Para um **Starter já instalado**, use o fluxo de atualização da plataforma. Na máquina da instalação, substitua `SUA_TAG_DA_PLATAFORMA` pela versão que será aplicada: ```bash theme={null} strattumctl plan SUA_TAG_DA_PLATAFORMA ``` Revise o plano, os serviços selecionados e as configurações. Depois, aplique o plano revisado: ```bash theme={null} strattumctl apply strattumctl status ``` O provisionamento inicial segue o processo de instalação da plataforma. `strattumctl plan` e `apply` tratam da atualização da instalação existente. ### Verifique a identificação pública ```bash theme={null} curl --fail https://anywhere.empresa.example/v1/installation ``` Confira a identificação do serviço e os campos de ambiente, quando definidos. Essa consulta verifica a identificação pública; o percurso de login e geração é conferido pela extensão. ### Percorra o uso da integração Confira os recursos comuns e, depois, o percurso específico da aplicação disponibilizada. Para o Zendesk, use [Seu primeiro atendimento no Zendesk](https://docs.strattum.ai/applications/anywhere/zendesk/quickstart.md). | Verificação | Resultado a conferir | | - | - | | Conectar pelo Chrome | Endereço aceito e ambiente apresentado | | Fazer login | Retorno ao painel com a conta correta | | Abrir registro autorizado | Contexto e leitura disponíveis na aplicação integrada | | Abrir Conexões | Fontes e vínculos esperados para a conta | | Gerar um rascunho | Texto ou estado de resultado coerente com as fontes | | Fazer uma pergunta | Resposta completa na conversa | | Abrir uma ficha | Conteúdo conforme a ontologia do cliente, relacionado à aplicação de origem | | Usar as ações da integração | Resultado no registro e no destino escolhidos, aguardando conclusão pelo usuário | ## Entregue à equipe Forneça o canal de instalação, o endereço do Gateway, as instruções de rede/VPN, a conta a utilizar, a aplicação integrada e o domínio autorizado. Encaminhe os [primeiros passos do Anywhere](https://docs.strattum.ai/applications/anywhere/quickstart.md), o guia da integração disponibilizada e o contato do responsável pelo suporte do ambiente. ## Próximos passos > **[Gerencie acessos e fontes](https://docs.strattum.ai/admin/anywhere/access.md)** > > Prepare as contas, os conectores e as fichas contextuais. > **[Instalação para o usuário](https://docs.strattum.ai/applications/anywhere/installation.md)** > > Compartilhe o percurso de instalação e conexão no navegador. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.