Oznameni

Amazon Web Services (AWS)

Integrace AWS poskytuje spolecne prihlasovaci udaje pro sluzby AWS a umi posilat oznamení pres Lambda, SNS, SQS nebo EventBridge. Je vhodna pro napojeni RichPear Home na existujici cloudovou infrastrukturu.

Nastavit AWS Zpet na integrace

Domena: aws
Typ: notify platforma
Komunikace: cloud-push
Nastaveni: configuration.yaml

Pripravte AWS ucet a pristupy

Pro pouziti potrebujete AWS ucet a pristupove udaje. AWS muze byt zpoplatnen podle pouzitych sluzeb, proto sledujte billing a nastavte si rozpoctova upozorneni.

Integrace pouziva stejne prihlasovaci udaje a profily jako AWS CLI. Muzete tedy zadat Access Key a Secret Key primo v konfiguraci, nebo pouzit profile_name z konfigurace AWS nastroju.

Podporovane cile oznamení

lambda pro vyvolani Lambda funkce.
sns pro publikovani do SNS tematu nebo endpointu.
sqs pro poslani zpravy do SQS fronty.
events pro poslani udalosti do EventBridge.

Pridejte AWS do configuration.yaml

Integrace se nastavuje rucne v konfiguracnim souboru. Nejprve definujte jednu nebo vice sad prihlasovacich udaju v casti credentials. Kazda sada ma vlastni name, na ktery se muzou odkazovat notify platformy.

Po ulozeni konfigurace provedte kontrolu konfigurace a restartujte RichPear Home.

Zakladni priklad

aws:
  credentials:
    - name: domaci_aws
      aws_access_key_id: AWS_ID
      aws_secret_access_key: AWS_SECRET
  notify:
    - service: lambda
      region_name: us-east-1
      credential_name: domaci_aws
      name: aws_lambda

Nastavte notify platformu

V casti notify vyberte hodnotu service. Povinne nastavte region_name; volitelne pridejte credential_name, pokud nechcete pouzit vychozi profil nebo primy par klicu.

Volba name urcuje nazev akce ve tvaru notify.NAZEV. Pokud jmeno nezadate, pouzije se vychozi notify nazev.

Dulezite volby

service: lambda, sns, sqs nebo events.
region_name: region AWS, napriklad us-east-1.
credential_name: odkaz na sadu prihlasovacich udaju z casti credentials.
context: volitelna data, ktera se predaji handleru oznamení.

Posilejte zpravy do AWS sluzeb

Po restartu pouzijte odpovidajici notify akci. U Lambda muze byt target nazev funkce, cely ARN nebo jeho cast. U SNS se jako target pouziva SNS topic nebo endpoint ARN. U SQS se posila URL fronty.

Payload obsahuje hodnoty title, message, target a volitelna data. Obsah data se preda vybrane AWS sluzbe podle typu notify platformy.

Priklad Lambda oznamení

action: notify.aws_lambda
data:
  title: "RichPear Home"
  message: "Senzor detekoval problem."
  target: "arn:aws:lambda:us-east-1:123456789012:function:ProcessHomeEvent"
  data:
    source: "richpear"
    severity: "warning"

Omezte opravneni a sledujte provoz

Pro RichPear Home vytvorte samostatneho IAM uzivatele nebo roli s nejmensim nutnym opravnenim. Pokud pouzivate pouze SNS, nedejte klici pristup k Lambda ani SQS.

U integrace, ktera muze spoustet Lambda funkce nebo publikovat zpravy, sledujte AWS logy a billing. Chybne nastavena automatizace muze vygenerovat velke mnozstvi udalosti.