Serviço de troca de token - AWS IoT Greengrass

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Serviço de troca de token

O componente de serviço de troca de tokens (aws.greengrass.TokenExchangeService) fornece credenciais da AWS que você pode usar para interagir com os serviços da AWS em seus componentes personalizados.

O serviço de troca de tokens executa uma instância de contêiner do Amazon Elastic Container Service (Amazon ECS) como um servidor local. Esse servidor local conecta-se ao provedor de credenciais do AWS IoT usando o alias de perfil do AWS IoT, que você configura no componente de núcleo principal do Greengrass. O componente fornece duas variáveis de ambiente. AWS_CONTAINER_CREDENTIALS_FULL_URI e AWS_CONTAINER_AUTHORIZATION_TOKEN. O AWS_CONTAINER_CREDENTIALS_FULL_URI define o URI para esse servidor local. Quando um componente cria um cliente do AWS SDK, o cliente reconhece essa variável de ambiente de URI e usa o token no AWS_CONTAINER_AUTHORIZATION_TOKEN para se conectar ao serviço de troca de tokens e recuperar as credenciais da AWS. Isso permite que os dispositivos principais do Greengrass chamem as operações de serviço da AWS. Para obter mais informações sobre como usar esse componente, consulte Interaja com AWS os serviços.

Importante

Em 13 de julho de 2016, o suporte para adquirir credenciais da AWS dessa forma foi incluído nos AWS SDKs. Seu componente deve usar uma versão do AWS SDK criada a partir dessa data. Para obter mais informações, consulte Como usar um AWS SDK com suporte no Guia do desenvolvedor do Amazon Elastic Container Service.

Versões

Esse componente tem as seguintes versões:

  • 2.0.x

Tipo

Esse é um componente genérico (aws.greengrass.generic). O Greengrass nucleus executa os scripts do ciclo de vida do componente.

Para obter mais informações, consulte Tipos de componentes.

Sistema operacional

Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:

  • Linux

  • Windows

Dependências

Esse componente não tem nenhuma dependência.

Configuração

Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente.

port

A porta a ser usada para conexões de serviço de troca de tokens. O serviço de troca de tokens será reiniciado após as alterações na configuração da porta.

exemplo Exemplo: atualização da mesclagem de configuração
{ "port": 2020 }

Arquivo de log local

Esse componente usa o mesmo arquivo de log do componente de Greengrass nucleus.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Para ver os logs desse componente
  • Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substitua /greengrass/v2 ou C:\greengrass\v2 pelo caminho para a pasta raiz do AWS IoT Greengrass.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

A tabela a seguir descreve as alterações em cada versão do componente.

Versão

Alterações

2.0.3

Versão inicial.