Tutoriel : Surveillez les modifications importantes apportées à votre organisation avec Amazon EventBridge

Connectez-vous à AWS en tant qu'administrateur du compte de gestion de l'organisation, puis ouvrez la CloudTrail console à l'adressehttps://console.aws.amazon.com/cloudtrail/.

Sur la barre de navigation dans le coin supérieur droit de la console, choisissez la région USA Est (Virginie du Nord). Si vous choisissez une autre région, AWS Organizations n'apparaît pas en tant qu'option dans les paramètres EventBridge de configuration d'Amazon et CloudTrail ne capture pas d'informations sur AWS Organizations.

Dans le panneau de navigation, choisissez Journaux d'activité.

Choisissez Créer un journal d'activité).

Pour Nom du journal d'activité, saisissez My-Test-Trail.

Exécutez l'une des options suivantes pour spécifier où CloudTrail doit être livré ses journaux :

Choisissez Suivant.

Sur la page Choisir les événements du journal, dans la section Événements de gestion, choisissez Read (Lire) et Write (Écrire).

Choisissez Suivant.

Passez en revue vos sélections, puis choisissez Create trail (Créer un journal d'activité).

Ouvrez le fichier AWS Lambda console àhttps://console.aws.amazon.com/lambda/.

Si vous débutez avec Lambda, choisissez Get Started Now (Démarrez maintenant) sur la page d'accueil ; sinon choisissez Create function (Créer une fonction).

Sur la page Créer une fonction, choisissez Use a blueprint (Utiliser un plan).

Dans la zone de recherche Blueprints (Plans), saisissez hello comme filtre et choisissez le plan hello-world.

Choisissez Configure (Configurer).

Sur la page Basic information (Informations de base), effectuez les opérations suivantes :

1. Pour le nom de la fonction Lambda, saisissez LogOrganizationEvents dans la zone de texte Name (Nom).

2. Pour Role (Rôle), choisissez Create a new role with basic Lambda permissions (Créer un nouveau rôle avec les autorisations Lambda de base). Ce rôle accorde à votre fonction Lambda les autorisations nécessaires pour accéder aux données dont celle-ci a besoin et pour écrire son journal de sortie.

Modifiez le code pour la fonction Lambda, comme illustré dans l'exemple suivant.

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');
};

Cet exemple de code enregistre l'événement avec une chaîne de LogOrganizationEvents marqueur suivie de la JSON chaîne qui le compose.

Sélectionnez Create function (Créer une fonction).

Ouvrez la SNS console Amazon à l'adressehttps://console.aws.amazon.com/sns/v3/.

Dans le panneau de navigation, choisissez Topics (Rubriques).

Choisissez Create new topic (Créer une rubrique).

1. Pour Topic name (Nom de la rubrique), saisissez OrganizationsCloudWatchTopic.

2. Pour Display name (Nom complet), saisissez OrgsCWEvnt.

3. Choisissez Create topic (Créer la rubrique).

Vous pouvez désormais créer un abonnement pour la rubrique. Choisissez ARN le sujet que vous venez de créer.

Choisissez Create subscription (Créer un abonnement).

1. Sur la page Create Subscription, pour Protocol (Protocole), choisissez Email (E-mail).

2. Saisissez votre adresse e-mail dans Endpoint (Point de terminaison).

3. Choisissez Create subscription (Créer un abonnement). AWS envoie un e-mail à l'adresse e-mail que vous avez spécifiée à l'étape précédente. Attendez que l'e-mail arrive, puis choisissez le lien Confirm subscription (Confirmer l'abonnement) contenu dans l'e-mail pour confirmer que vous avez bien reçu l'e-mail.

4. Revenez dans la console et actualisez la page. Le message Pending confirmation (En attente de confirmation) disparaît et est remplacé par l'ID d'abonnement désormais valide.

Ouvrez la EventBridge console Amazon à l'adressehttps://console.aws.amazon.com/events/.

Définissez la console sur la région USA Est (Virginie du Nord), faute de quoi les informations sur Organizations ne sont pas disponibles. Sur la barre de navigation dans le coin supérieur droit de la console, choisissez la région USA Est (Virginie du Nord).

Pour obtenir des instructions sur la création de règles, consultez Getting started with Amazon EventBridge dans le guide de EventBridge l'utilisateur Amazon.

Ouvrez la CloudWatch console à l'adressehttps://console.aws.amazon.com/cloudwatch/.

Dans la page de navigation, choisissez Logs (Journaux).

Sous Log Groups, choisissez le groupe associé à votre fonction Lambda : /aws/lambda/. LogOrganizationEvents

Chaque groupe contient un ou plusieurs flux, et il devrait y avoir un groupe pour aujourd'hui. Choisissez-le.

Affichez le journal. Vous devriez voir des lignes similaires aux suivantes.

Sélectionnez la ligne du milieu de l'entrée pour voir le JSON texte intégral de l'événement reçu. Vous pouvez voir tous les détails de la API demande dans les responseElements parties requestParameters et de la sortie.

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"
    }
}

Vérifiez si votre compte e-mail contient un message provenant de O rgsCWEvnt (le nom d'affichage de votre SNS rubrique Amazon). Le corps de l'e-mail contient le même JSON texte de sortie que l'entrée du journal affichée à l'étape précédente.

Utilisez la CloudTrail console pour supprimer le parcours nommé My-Test-Trail que vous avez créé à l'étape 1.

Si vous avez créé un compartiment Amazon S3 à l'étape 1, utilisez la console Amazon S3 pour le supprimer.

Utilisez la console Lambda pour supprimer la fonction nommée LogOrganizationEvents que vous avez créée à l'étape 2.

Utilisez la SNSconsole Amazon pour supprimer le SNS sujet Amazon nommé OrganizationsCloudWatchTopic que vous avez créé à l'étape 3.

Utilisez la CloudWatch console pour supprimer la EventBridge règle nommée OrgsMonitorRule que vous avez créée à l'étape 4.

Enfin, utilisez la console Organizations pour supprimer l'unité d'organisation nommée TestCWEOU que vous avez créée à l'étape 5.