Tutorial: monitora le modifiche importanti alla tua organizzazione con Amazon EventBridge

Accedi a AWS come amministratore dell'account di gestione dell'organizzazione, quindi apri la CloudTrail console all'indirizzohttps://console.aws.amazon.com/cloudtrail/.

Nella barra di navigazione nell'angolo in alto a destra della console, scegli la Regione Stati Uniti orientali (Virginia settentrionale). Se scegli una regione diversa, AWS Organizations non appare come opzione nelle impostazioni di EventBridge configurazione di Amazon e CloudTrail non acquisisce informazioni su AWS Organizations.

Nel riquadro di navigazione selezionare Trails (Percorso).

Scegliere Create trail (Creare trail).

In Trail name (Nome trail), immettere My-Test-Trail.

Esegui una delle seguenti opzioni per specificare dove CloudTrail inviare i log:

Scegli Next (Successivo).

Nella pagina Choose log events (Scegli eventi di log), nella sezione Management events (Eventi di gestione), scegli Read (Lettura) e Write (Scrittura).

Scegli Next (Successivo).

Rivedi le selezioni effettuate, quindi scegli Create trail (Crea trail).

Apri il AWS Lambda console all'indirizzohttps://console.aws.amazon.com/lambda/.

Se non hai esperienza con Lambda, scegli Get Started Now (Inizia ora) sulla pagina di benvenuto. Altrimenti scegli Create function (Crea funzione).

Nella pagina Create function (Crea funzione) scegliere Use a blueprint (Usa un piano).

Dal riquadro di ricerca Blueprint, immettere hello per il filtro e scegliere la blueprint hello-world.

Scegli Configura.

Nella pagina Basic information (Informazioni di base), procedere come segue:

1. Per il nome della funzione Lambda, inserisci LogOrganizationEvents nella casella di testo Name (Nome).

2. In Role (Ruolo), scegliere Create a new role with basic Lambda permissions (Crea un nuovo ruolo con le autorizzazioni Lambda di base). Questo ruolo concede alla tua funzione Lambda le autorizzazioni per accedere ai dati necessari e per scriverli nel log di output.

Modifica il codice per la funzione Lambda, come mostrato nell'esempio seguente.

console.log('Loading function');

exports.handler = async (event, context) => {
    console.log('LogOrganizationsEvents');
    console.log('Received event:', JSON.stringify(event, null, 2));
    return event.key1;  // Echo back the first key value
    // throw new Error('Something went wrong');
};

Questo codice di esempio registra l'evento con una stringa LogOrganizationEvents marker seguita dalla JSON stringa che lo compone.

Scegli Crea funzione.

Apri la SNS console Amazon all'indirizzohttps://console.aws.amazon.com/sns/v3/.

Nel pannello di navigazione, scegli Topics (Argomenti).

Scegli Create new topic (Crea nuovo argomento).

1. Per Topic name (Nome argomento), immettere OrganizationsCloudWatchTopic.

2. Per Display name (Nome visualizzato), inserire OrgsCWEvnt.

3. Scegli Create topic (Crea argomento).

Puoi ora creare una sottoscrizione per l'argomento. Scegli ARN il argomento che hai appena creato.

Scegli Crea sottoscrizione.

1. Nella pagina Create subscription (Crea sottoscrizione) scegli Email (E-mail) in Protocol (Protocollo).

2. Per Endpoint, immettere il proprio indirizzo e-mail.

3. Scegli Crea sottoscrizione. AWS invia un'e-mail all'indirizzo e-mail specificato nel passaggio precedente. Attendere l'arrivo dell'e-mail, quindi scegliere il link Confirm subscription (Conferma abbonamento) nell'e-mail per verificare l'avvenuta ricezione dell'e-mail.

4. Torna alla console e aggiorna la pagina. Il messaggio Pending confirmation (Conferma in sospeso) non verrà più visualizzato e verrà sostituito dall'ID di sottoscrizione attualmente valido.

Apri la EventBridge console Amazon all'indirizzohttps://console.aws.amazon.com/events/.

Imposta la console sulla regione Stati Uniti orientali (Virginia settentrionale), altrimenti le informazioni su Organizations non saranno disponibili. Nella barra di navigazione nell'angolo in alto a destra della console, scegli la Regione Stati Uniti orientali (Virginia settentrionale).

Per istruzioni sulla creazione di regole, consulta la sezione Guida introduttiva ad Amazon EventBridge nella guida per EventBridge l'utente di Amazon.

Apri la CloudWatch console all'indirizzohttps://console.aws.amazon.com/cloudwatch/.

Nella pagina di navigazione scegli Log.

In Gruppi di log, scegli il gruppo associato alla tua funzione Lambda: /aws/lambda/. LogOrganizationEvents

Ogni gruppo contiene uno o più flussi e per il giorno odierno dovrebbe esserci un gruppo. Sceglilo.

Visualizza il log. Dovresti vedere righe simili alla seguente:

Seleziona la riga centrale della voce per visualizzare il testo completo JSON dell'evento ricevuto. Puoi vedere tutti i dettagli della API richiesta nella sezione requestParameters e nelle responseElements parti dell'output.

2017-03-09T22:45:05.101Z 0999eb20-051a-11e7-a426-cddb46425f16 Received event:
{
    "version": "0",
    "id": "123456-EXAMPLE-GUID-123456",
    "detail-type": "AWS API Call via CloudTrail",
    "source": "aws.organizations",
    "account": "123456789012",
    "time": "2017-03-09T22:44:26Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "eventVersion": "1.04",
        "userIdentity": {
            ...
        },
        "eventTime": "2017-03-09T22:44:26Z",
        "eventSource": "organizations.amazonaws.com",
        "eventName": "CreateOrganizationalUnit",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "192.168.0.1",
        "userAgent": "AWS Organizations Console, aws-internal/3",
        "requestParameters": {
            "parentId": "r-exampleRootId",
            "name": "TestCWEOU"
        },
        "responseElements": {
            "organizationalUnit": {
                "name": "TestCWEOU",
                "id": "ou-exampleRootId-exampleOUId",
                "arn": "arn:aws:organizations::1234567789012:ou/o-exampleOrgId/ou-exampleRootId-exampeOUId"
            }
        },
        "requestID": "123456-EXAMPLE-GUID-123456",
        "eventID": "123456-EXAMPLE-GUID-123456",
        "eventType": "AwsApiCall"
    }
}

Controlla se nel tuo account e-mail è presente un messaggio di O rgsCWEvnt (il nome visualizzato del tuo SNS argomento su Amazon). Il corpo dell'e-mail contiene lo stesso JSON testo in uscita della voce di registro mostrata nel passaggio precedente.

Usa la CloudTrail console per eliminare il percorso denominato My-Test-Trail che hai creato nel passaggio 1.

Se nella fase 1 hai creato un bucket Amazon S3, utilizza la console Amazon S3 per eliminarlo.

Utilizza la console Lambda per eliminare la funzione denominata LogOrganizationEvents creata nella fase 2.

Usa la SNSconsole Amazon per eliminare l'SNSargomento Amazon denominato OrganizationsCloudWatchTopic che hai creato nel passaggio 3.

Usa la CloudWatch console per eliminare la EventBridge regola denominata OrgsMonitorRule che hai creato nel passaggio 4.

Utilizza la console Organizations per eliminare l'unità organizzativa denominata TestCWEOU creata alla fase 5.