Criar um perfil do IAM e regra de IoT para o destino

Criar uma função e uma política de execução

Crie um perfil do IAM que dá à sua função permissão para acessar recursos da AWS. Também é possível definir a política de confiança para a função usando um arquivo JSON.

aws iam create-role --role-name lambda-ex \ 
    --assume-role-policy-document file://lambda-trust-policy.json

O exemplo a seguir mostra o conteúdo do arquivo JSON.

Conteúdo do lambda-trust-policy.json

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "lambda.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Criar e testar a função do Lambda

Execute as etapas a seguir para criar uma função do AWS Lambda que permita que base64 decodifique os dados da carga útil.

1. Escreva o código para decodificar os dados da carga útil. Você pode usar o exemplo de código Python a seguir. Especifique um nome para o script, como base64_decode.py.

   Conteúdo do base64_decode.py

   // -----------------------------------------------------------
   // ----- Python script to decode incoming binary payload -----
   // -----------------------------------------------------------
   import json
   import base64
   
   def lambda_handler(event, context):
   
       message = json.dumps(event)
       print (message)
   
       payload_data = base64.b64decode(event["PayloadData"])
       print(payload_data)
       print(int(payload_data,16))

2. Criar um pacote de implantação como um arquivo zip que contenha o arquivo Python e nomeá-lo como base64_decode.zip. Use a API CreateFunction ou o comando da CLI create-function para criar uma função do Lambda para o código de amostra, base64_decode.py.

3. aws lambda create-function --function-name my-function \
   --zip-file fileb://base64_decode.zip --handler index.handler \ 
   --runtime python3.9 --role arn:aws:iam::123456789012:role/lambda-ex

   Você verá a saída a seguir. Você usará o valor do nome do recurso da Amazon (ARN) da saída,FunctionArn, ao criar a regra de tópico.

   {
       "FunctionName": "my-function",
       "FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function",
       "Runtime": "python3.9",
       "Role": "arn:aws:iam::123456789012:role/lambda-ex",
       "Handler": "index.handler",
       "CodeSha256": "FpFMvUhayLkOoVBpNuNiIVML/tuGv2iJQ7t0yWVTU8c=",
       "Version": "$LATEST",
       "TracingConfig": {
           "Mode": "PassThrough"
       },
       "RevisionId": "88ebe1e1-bfdf-4dc3-84de-3017268fa1ff",
       ...
   }

4. Para obter logs para uma invocação a partir da linha de comando, use a opção --log-type com o comando invoke. A resposta inclui um campo LogResult que contém até 4 KB de logs codificados em base64 da invocação.

   aws lambda invoke --function-name my-function out --log-type Tail

   Você receberá uma resposta com um StatusCode de 200. Para obter mais informações sobre como criar e usar as funções do Lambda com a AWS CLI, consulte Como usar o Lambda com a AWS CLI.

Criar uma regra de tópico

Use a API CreateTopicRule ou o comando da CLI create-topic-rule para criar uma regra de tópico que envia uma mensagem para essa função do Lambda. Você também pode adicionar uma segunda ação de regra que republica em um tópico de AWS IoT. Nomeie essa regra de tópico como Sidewalkrule.

aws iot create-topic-rule --rule-name Sidewalkrule \ 
    --topic-rule-payload file://myrule.json

Você pode usar o arquivo myrule.json para especificar mais detalhes sobre a regra. Por exemplo, o arquivo JSON a seguir mostra como republicar em um tópico de AWS IoT e enviar uma mensagem para uma função do Lambda.

{
    "sql": "SELECT * ",
    "actions": [
       {
            // You obtained this functionArn when creating the Lambda function using the 
            // create-function command.
            "lambda": {
                "functionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function"
             }
        },
        {
            // This topic can be used to observe messages exchanged between the device and 
            // AWS IoT Core for Amazon Sidewalk after the device is connected.
             "republish": {
                 "roleArn": "arn:aws:iam::123456789012:role/service-role/SidewalkRepublishRole",
                 "topic": "project/sensor/observed"
             }
        }
    ],
}