Amazon Web Services (AWS)

01

Připravte vlastní AWS účet a přístupy

Pro použití potřebujete vlastní AWS účet a přístupové údaje s oprávněním k vybrané službě. AWS nabízí vybrané bezplatné limity, ale provoz může být zpoplatněn, když limity překročíte nebo zapnete placenou službu. Sledujte proto AWS Billing a nastavte si rozpočtová upozornění.

RichPear Home používá stejný způsob přihlášení jako AWS CLI. Můžete zadat dvojici aws_access_key_id a aws_secret_access_key, nebo odkázat na profil přes profile_name. Nepoužívejte cizí účty, sdílené klíče ani tokeny stažené z internetu.

02

Přidejte AWS do configuration.yaml

Integrace se nastavuje ručně v souboru configuration.yaml. Nejprve definujte jednu nebo více sad přístupových údajů v části credentials. Každá sada má vlastní name, na které se potom odkazují jednotlivá oznámení.

Volba validate je ve výchozím stavu zapnutá a při startu ověřuje přístup přes IAM.GetUser. Pokud klíč nemá toto oprávnění, nastavte validate: false a povolte mu jen akce, které opravdu používáte.

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
    - service: events
      region_name: us-east-1
      credential_name: domaci_aws
      name: aws_events

03

Nastavte oznámení

V části notify vyberte hodnotu service. Povinný je také region_name, například us-east-1. Oznámení může použít přístupové údaje z credentials, vlastní dvojici klíčů, AWS profil, nebo výchozí profil uložený v ~/.aws.

Volba name určuje název akce ve tvaru notify.NAZEV. Pokud ji nezadáte, použije se výchozí název notify.

04

Posílejte zprávy do AWS služeb

Po uložení změn restartujte RichPear Home a použijte odpovídající akci notify. U Lambda může být target název funkce, celý ARN nebo částečný ARN. U SNS se používá ARN tématu nebo endpointu. U SQS se zadává URL fronty.

Payload může obsahovat title, message, target a volitelná data. Lambda dostane celý payload jako JSON. SNS použije title jako subject a položky z data předá jako message attributes. SQS odešle JSON zprávu a atributy zprávy.

EventBridge používá jako target název event busu; když target vynecháte, odešle událost do výchozího event busu. Detail události se bere z data.detail, jinak se vytvoří jednoduchý detail z hodnoty message.

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

action: notify.aws_events
data:
  message: "Automatizace odeslala událost."
  target:
    - "richpear-events"
  data:
    source: "richpear"
    detail_type: "richpear_event"
    detail:
      room: "technicka"
      severity: "info"

05

Omezte oprávnění a sledujte provoz

Pro RichPear Home vytvořte samostatného IAM uživatele nebo roli s nejmenším nutným oprávněním. Pokud používáte jen SNS, nedávejte stejnému klíči přístup k Lambda, SQS ani EventBridge.

U integrace, která může spouštět Lambda funkce nebo publikovat zprávy, sledujte AWS logy i účtování. Chybně nastavená automatizace může vytvořit velké množství událostí.