Como criar um recurso de segredo (console)

Faça login no console do AWS Secrets Manager.

Selecione Store a new secret (Armazenar um novo segredo).

Em Escolher tipo de segredo, selecione Outro tipo de segredo.

Em Specify the key/value pairs to be stored for this secret (Especificar os pares de chave/valor a serem armazenados para este segredo):

Mantenha aws/secretsmanager selecionado para a chave de criptografia e selecione Avançar.

Em Secret name, digite greengrass-TestSecret e selecione Next.

A alternância não é necessária neste tutorial, portanto, selecione Desabilitar a alternância automática e, em seguida, Avançar.

Na página Review (Revisar), revise as configurações e selecione Store (Armazenar).

Em seguida, crie um recurso de segredo no seu grupo do Greengrass que faz referência ao segredo.

No painel de navegação do console de AWS IoT, em Gerenciar, expanda Dispositivos Greengrass e, em seguida selecione Grupos (V1).

Selecione o grupo ao qual você deseja adicionar o recurso de segredo.

Na página de configuração do grupo, selecione a guia Recursos e, em seguida, role para baixo até a seção Segredos. A seção Segredos exibe os recursos de segredos que pertencem ao grupo. Você pode adicionar, editar e remover recursos de segredos nessa seção.

Selecione Adicionar na seção Segredos.

Na página Adicionar um recurso de segredo, insira MyTestSecret em Nome do recurso.

Em Segredo, selecione greengrass-TestSecret.

Na seção ‭‬Selecionar rótulos (Opcional)‭‬, o rótulo de preparação AWSCURRENT representa a versão mais recente do segredo.‬‬‬‬‬‬. Esse rótulo é sempre incluído em um recurso de segredo.

Selecione Adicionar recurso.

Na página de downloads do SDK do AWS IoT Greengrass Core, baixe o AWS IoT Greengrass SDK do Core para Python em seu computador.

Descompacte o pacote obtido por download para obter o SDK. O SDK é a pasta do greengrasssdk.

Salve a seguinte função do código Python em um arquivo local denominado secret_test.py.

import greengrasssdk

secrets_client = greengrasssdk.client("secretsmanager")
iot_client = greengrasssdk.client("iot-data")
secret_name = "greengrass-TestSecret"
send_topic = "secrets/output"


def function_handler(event, context):
    """
    Gets a secret and publishes a message to indicate whether the secret was
    successfully retrieved.
    """
    response = secrets_client.get_secret_value(SecretId=secret_name)
    secret_value = response.get("SecretString")
    message = (
        f"Failed to retrieve secret {secret_name}."
        if secret_value is None
        else f"Successfully retrieved secret {secret_name}."
    )
    iot_client.publish(topic=send_topic, payload=message)
    print("Published: " + message)

A função get_secret_value oferece suporte ao nome ou ARN do segredo do Secrets Manager para o valor SecretId. Esse exemplo usa o nome do segredo. Para este segredo de exemplo, o AWS IoT Greengrass retorna o segredo do par de chave-valor: {"test":"abcdefghi"}.

Comprima os seguintes itens em um arquivo denominado secret_test_python.zip. Quando você criar o arquivo ZIP, inclua apenas o código e suas dependências, e não a pasta que contém os arquivos.

Esse é o pacote de implantação de sua função do Lambda.

Primeiro, crie a função do Lambda.

1. No AWS Management Console, selecione Services (Serviços) e abra o console do AWS Lambda.

2. Selecione Criar função e Criar desde o início.

3. Na seção Basic information (Informações básicas), use os seguintes valores:

   • Em Function name (Nome da função), insira SecretTest.

   • Em Runtime (Tempo de execução), selecione Python 3.7.

   • Em Permissões, mantenha a configuração padrão. Isso cria uma função de execução que concede permissões básicas do Lambda. Essa função não é usada pelo AWS IoT Greengrass.

4. Na parte inferior da página, selecione Create function.

Em seguida, registre o manipulador e faça upload do seu pacote de implantação da função do Lambda.

1. Na guia Código, em Fonte do código, selecione Fazer upload a partir de. No menu suspenso, selecione o arquivo .zip.

   

2. Selecione Upload e, em seguida, selecione seu pacote de implantação secret_test_python.zip. Selecione Salvar.

3. Na guia Código da função, em Configurações de runtime, selecione Editar e insira os valores a seguir.

   • Em Runtime (Tempo de execução), selecione Python 3.7.

   • Em Handler (Manipulador), insira secret_test.function_handler.

4. Selecione Salvar.

   nota

   O botão Testar no console do AWS Lambda não funciona com essa função. O AWS IoT GreengrassSDK do Core não contém módulos necessários para executar suas funções do Lambda do Greengrass de forma independente no console do AWS Lambda. Esses módulos (por exemplo, greengrass_common) são fornecidos às funções depois de serem implantados no núcleo do Greengrass.

Agora, publique a primeira versão da sua função do Lambda e crie um alias para a versão.

1. No menu Actions, selecione Publish new version.

2. Em Version description (Descrição da versão), insira First version e, em seguida, selecione Publish (Publicar).

3. Na página de configuração SecretTest: 1, no menu Actions (Ações), selecione Create alias (Criar alias).

4. Na página Create a new alias, use os seguintes valores:

   • Em Name (Nome), insira GG_SecretTest.

   • Em Version, selecione 1.

   nota

   O AWS IoT Greengrass não oferece suporte a alias do Lambda para as versões $LATEST.

5. Selecione Create (Criar).

Na página de configuração do grupo, selecione a guia Funções do Lambda.

Na seção Minhas funções do Lambda, selecione Adicionar.

Para a Função do Lambda, selecione SecretTest.

Para a Versão da função do Lambda, selecione o alias para a versão que você publicou.

Na seção Configuração da função do Lambda, faça as atualizações a seguir.

1. Para executar sem conteinerização:

   • Para Usuário e grupo do sistema, selecione Another user ID/group ID. Para ID de usuário do sistema, insira 0. Para ID do grupo do sistema, insira 0.

     Isso permite que sua função do Lambda seja executada como root. Para obter mais informações sobre como executar como raiz, consulte Definir a identidade de acesso padrão para as funções do Lambda em um grupo.

     dica

     Você também deve atualizar seu arquivo config.json para conceder acesso root à sua função do Lambda. Para o procedimento, consulte Executar uma função do Lambda como raiz.

   • Para Conteinerização da função do Lambda, selecione Sem contêiner.

     Para obter mais informações sobre como executar sem conteinerização, consulte Considerações ao escolher a conteinerização de função do Lambda.

   • Em Timeout (Tempo limite), insira 10 seconds.

   • Para Fixado, selecione Verdadeiro.

     Para obter mais informações, consulte Configuração do ciclo de vida das funções do Lambda do Greengrass.

   • Em Parâmetro adicional, para Acesso de leitura ao diretório /sys, selecione Habilitado.

2. Em vez disso, para executar no modo conteinerizado:

   nota

   Não recomendamos a execução no modo conteinerizado, a menos que seu caso de negócios faça essa exigência.

   • Para Usuário e grupo do sistema, selecione Usar padrão de grupo.

   • Para a Conteinerização da função do Lambda, selecione Usar grupo padrão.

   • Em Memory limit (Limite de memória), insira 1024 MB.

   • Em Timeout (Tempo limite), insira 10 seconds.

   • Para Fixado, selecione Verdadeiro.

     Para obter mais informações, consulte Configuração do ciclo de vida das funções do Lambda do Greengrass.

   • Em Parâmetros adicionais, para Acesso de leitura ao diretório /sys, selecione Habilitado.

Selecione Adicionar função do Lambda.

Na página de configuração do grupo, selecione a guia Funções do Lambda.

Selecione a função SecretTest.

Na página de detalhes da função, selecione Recursos.

Role até a seção Segredos e selecione Associar.

Selecione MyTestSecret e, em seguida, selecione Associar.

Na página de configuração do grupo, selecione a guia Assinaturas e, em seguida, Adicionar assinatura.

Crie uma assinatura que permita que a AWS IoT publique mensagens na função.

Na página de configuração do grupo, selecione a guia Assinaturas e, em seguida, Adicionar assinatura.

Na página Criar uma assinatura, configure a origem e o destino, da seguinte forma:

1. Em Tipo de origem, selecione Função do Lambda e, em seguida, selecione IoT Cloud.

2. Em Tipo de destino, selecione Serviço e, em seguida, selecione SecretTest.

3. Em Filtro de tópicos, insira secrets/input e, em seguida, selecione Criar assinatura.

Adicione uma segunda assinatura. Selecione a guia Assinaturas, selecione Adicionar assinatura e configure a origem e o destino, da seguinte forma:

1. Em Tipo de origem, selecione Serviços e, em seguida, selecione SecretTest.

2. Em Tipo de destino, selecione Função do Lambda e, em seguida, selecione IoT Cloud.

3. Em Filtro de tópicos, insira secrets/output e, em seguida, selecione Criar assinatura.

Verifique se o núcleo AWS IoT Greengrass está em execução. Execute os seguintes comandos no seu terminal do Raspberry Pi, conforme necessário.

1. Para verificar se o daemon está em execução:

   ps aux | grep -E 'greengrass.*daemon'

   Se a saída contém uma entrada root para /greengrass/ggc/packages/ggc-version/bin/daemon, o daemon está em execução.

   nota

   A versão no caminho depende da versão do software do AWS IoT Greengrass Core que foi instalada no seu dispositivo de núcleo.

2. Para iniciar o daemon:

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

Na página de configuração do grupo, selecione Implantar.

1. Na guia Funções do Lambda, na seção Funções do Lambda do sistema, selecione Detector de IP e selecione Editar.

2. Na caixa de diálogo Editar configurações do detector IP, selecione Detectar e substituir automaticamente os endpoints do corretor MQTT.

3. Selecione Salvar.

   Isso permite que os dispositivos adquiram automaticamente as informações de conectividade para o núcleo, como endereço IP, DNS e o número da porta. A detecção automática é recomendada, mas o AWS IoT Greengrass também oferece suporte a endpoints especificados manualmente. Você só é solicitado pelo método de descoberta na primeira vez em que o grupo for implantado.

   nota

   Se solicitado, conceda permissão para criar o perfil de serviço do Greengrass e associá-lo à sua Conta da AWS na Região da AWS atual. Essa função permite que AWS IoT Greengrass acessem seus recursos nos serviços do AWS.

   A página Deployments mostra a data e hora, ID de versão e status da implantação. Quando concluída, o status exibido para a implantação deve ser Concluída.

   Para obter ajuda sobre a solução de problemas, consulte Solução de problemas de AWS IoT Greengrass.

Na página inicial do console do AWS IoT, selecione Testar.

Em Inscrever-se no tópico, use os seguintes valores e, em seguida, selecione Inscrever-se.

Para Publicar no tópico, use os valores a seguir e, em seguida selecione Publicar para invocar a função.

Se for bem-sucedida, a função publicará uma mensagem de "Êxito".