View a markdown version of this page

Configuration de l'authentification par jeton du porteur - Amazon CloudWatch Journaux

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration de l'authentification par jeton du porteur

Note

Cette page couvre l'authentification par jeton du porteur pour CloudWatch Journaux. Pour CloudWatch Métriques : authentification par jeton au porteur, voir Configuration de l'authentification par jeton au porteur pour Metrics dans le CloudWatch Guide de l'utilisateur. Pour l'authentification par jeton du porteur de traces, voir Configuration de l'authentification par jeton du porteur pour les traces dans le X-Ray Guide du développeur. Chaque service nécessite sa propre clé API.

Avant de pouvoir envoyer des journaux à l'aide de l'authentification par jeton du porteur avec l'un des points de terminaison d'ingestion HTTP, vous devez :

  • Créez un utilisateur IAM avec CloudWatch Consigne les autorisations

  • Générez des informations d'identification spécifiques au service (jeton porteur)

  • Création d'un groupe de journaux et d'un flux de journaux

  • Activer l'authentification par jeton du porteur sur le groupe de journaux

Important

Nous recommandons d’utiliser l’authentification SigV4 avec des informations d’identification à court terme pour toutes les charges de travail où cela est possible. SigV4 offre la posture de sécurité la plus robuste. Limitez l'utilisation des clés API (jetons porteurs) aux scénarios dans lesquels une authentification à court terme basée sur des informations d'identification n'est pas possible. Lorsque vous êtes prêt à intégrer CloudWatch Pour vous connecter à des applications présentant des exigences de sécurité plus strictes, vous devez passer à des informations d'identification à court terme. Pour en savoir plus, consultez Solutions de remplacement des clés d’accès à long terme dans le Guide de l’utilisateur IAM.

Option 1 : Démarrage rapide à l'aide du AWS console

Le AWS La console de gestion fournit un flux de travail rationalisé pour générer des clés d'API pour l'accès aux points de terminaison HTTP.

Pour configurer l'accès aux points de terminaison HTTP à l'aide de la console
  1. Connectez-vous au AWS Console de gestion.

  2. Naviguez vers CloudWatch > Réglages > Journaux.

  3. Dans la section Clés d’API, choisissez Générer une clé d’API.

  4. Pour Epiration de la clé d’API, effectuez l’une des actions suivantes :

    • Sélectionnez un délai d’expiration de la clé d’API de 1, 5, 30, 90 ou 365 jours.

    • Choisissez Durée personnalisée pour spécifier une date d’expiration personnalisée pour la clé d’API.

    • Sélectionnez N’expire jamais (non recommandé).

  5. Choisissez Générer une clé d’API.

    La console effectue automatiquement les opérations suivantes :

    • Crée un utilisateur IAM avec les autorisations appropriées

    • Attache le CloudWatchLogsAPIKeyAccess politique gérée (inclut logs:PutLogEvents et logs:CallWithBearerToken autorisations)

    • Génère des informations d’identification propres au service (clé d’API)

  6. Copiez et enregistrez en lieu sûr les informations d’identification affichées :

    • ID de clé API (Service-specific identifiant d'identification)

    • Secret de clé d’API (jeton porteur)

    Important

    Enregistrez immédiatement le secret de la clé d’API. Vous ne pourrez pas la récupérer ultérieurement. Si vous la perdez, vous devrez générer une nouvelle clé API.

  7. Créez le groupe de journaux et le flux de journaux dans lesquels vos journaux seront stockés :

    # Create the log group aws logs create-log-group \ --log-group-name /aws/hlc-logs/my-application \ --region us-east-1 # Create the log stream aws logs create-log-stream \ --log-group-name /aws/hlc-logs/my-application \ --log-stream-name application-stream-001 \ --region us-east-1
  8. Activez l'authentification par jeton du porteur sur le groupe de journaux :

    aws logs put-bearer-token-authentication \ --log-group-identifier /aws/hlc-logs/my-application \ --bearer-token-authentication-enabled \ --region us-east-1

    Vérifiez la configuration :

    aws logs describe-log-groups \ --log-group-name-prefix /aws/hlc-logs/my-application \ --region us-east-1

Les autorisations incluaient : L'utilisateur IAM créé automatiquement disposera des autorisations suivantes :

  • logs:PutLogEvents — Envoyer les événements du journal à CloudWatch Journaux

  • logs:CallWithBearerToken — Authentifiez-vous à l'aide du jeton du porteur

  • kms:Describe*, kms:GenerateDataKey*, kms:Decrypt — Accès KMS-encrypted groupes de journaux (avec condition limitée au service de journaux)

Option 2 : configuration manuelle

Si vous préférez mieux contrôler la configuration IAM ou si vous souhaitez personnaliser les autorisations, vous pouvez configurer l'accès au point de terminaison HTTP manuellement.

Étape 1 : Création d'un utilisateur IAM

Créez un utilisateur IAM qui sera utilisé pour l'ingestion des journaux :

  1. Connectez-vous au AWS Console de gestion et accédez à IAM.

  2. Dans le volet de navigation de gauche, choisissez Utilisateurs.

  3. Choisissez Create user (Créer un utilisateur).

  4. Saisissez un nom d’utilisateur (par exemple, cloudwatch-logs-hlc-user).

  5. Choisissez Suivant.

  6. Attachez l’une des politiques IAM suivantes :

    Option A : utiliser la politique gérée (recommandé)

    Joignez le CloudWatchLogsAPIKeyAccess politique gérée.

    Option B : créer une politique personnalisée

    Créez et attachez la politique IAM suivante :

    { "Version": "2012-10-17", "Statement": [ { "Sid": "LogsAPIs", "Effect": "Allow", "Action": [ "logs:CallWithBearerToken", "logs:PutLogEvents" ], "Resource": "*" }, { "Sid": "KMSAPIs", "Effect": "Allow", "Action": [ "kms:Describe*", "kms:GenerateDataKey*", "kms:Decrypt" ], "Condition": { "StringEquals": { "kms:ViaService": [ "logs.*.amazonaws.com" ] } }, "Resource": "arn:aws:kms:*:*:key/*" } ] }
  7. Choisissez Suivant et puis Créer un utilisateur.

Note

Les autorisations KMS sont requises si vous prévoyez d'envoyer des journaux à KMS-encrypted groupes de journaux. La condition limite l'accès au KMS aux seules clés utilisées via CloudWatch Service de journaux.

Étape 2 : générer des informations d’identification propres au service (clé d’API)

Générez le CloudWatch Enregistre la clé API à l'aide du CreateServiceSpecificCredential API. Vous pouvez également utiliser le créer un identifiant spécifique à un service Commande CLI. Pour la durée de validité des informations d’identification, vous pouvez spécifier une valeur dans la plage 1–36600 jours. Si vous ne spécifiez pas de durée de validité, la clé d’API n’expirera pas.

Pour générer une clé d’API avec une expiration après 30 jours :

aws iam create-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-name logs.amazonaws.com \ --credential-age-days 30

La réponse est ServiceSpecificCredential objet. Le ServiceCredentialSecret votre valeur est votre CloudWatch Enregistre la clé API (jeton du porteur).

Important

Stockez la valeur ServiceCredentialSecret en toute sécurité, car vous ne pourrez pas la récupérer ultérieurement. Si vous la perdez, vous devrez générer une nouvelle clé API.

Étape 3 : Création d'un groupe de journaux et d'un flux de journaux

Créez le groupe de journaux et le flux de journaux dans lesquels vos journaux seront stockés :

# Create the log group aws logs create-log-group \ --log-group-name /aws/hlc-logs/my-application \ --region us-east-1 # Create the log stream aws logs create-log-stream \ --log-group-name /aws/hlc-logs/my-application \ --log-stream-name application-stream-001 \ --region us-east-1

Étape 4 : activer l'authentification par jeton du porteur

Activez l'authentification par jeton du porteur sur le groupe de journaux :

aws logs put-bearer-token-authentication \ --log-group-identifier /aws/hlc-logs/my-application \ --bearer-token-authentication-enabled \ --region us-east-1

Vérifiez la configuration :

aws logs describe-log-groups \ --log-group-name-prefix /aws/hlc-logs/my-application \ --region us-east-1

Contrôlez les autorisations de génération et d'utilisation CloudWatch Consigne les clés d'API

La génération et l'utilisation de CloudWatch Les clés d'API Logs sont contrôlées par des actions et des clés de condition à la fois dans CloudWatch Journaux et services IAM.

Contrôler la génération de CloudWatch Consigne les clés d'API

Le iam :CreateServiceSpecificCredential l'action contrôle la génération d'une clé spécifique au service (telle qu'une CloudWatch Journalise la clé API). Vous pouvez étendre cette action aux utilisateurs IAM en tant que ressource afin de limiter le nombre d’utilisateurs pour lesquels une clé peut être générée.

Vous pouvez utilisez les clés de condition suivantes pour imposer des conditions à l’autorisation pour l’action iam:CreateServiceSpecificCredential :

  • iam :ServiceSpecificCredentialAgeDays — Permet de spécifier, dans la condition, le délai d'expiration de la clé en jours. Par exemple, vous pouvez utiliser cette clé de condition pour autoriser uniquement des clés API qui expirent au terme d’un délai de 90 jours.

  • iam :ServiceSpecificCredentialServiceName — Permet de spécifier, dans la condition, le nom d'un service. Par exemple, vous pouvez utiliser cette clé de condition pour autoriser uniquement la création de clés d'API pour CloudWatch Logs et non d'autres services.

Contrôle de l'utilisation de CloudWatch Consigne les clés d'API

Le logs:CallWithBearerToken l'action contrôle l'utilisation d'un CloudWatch Enregistre la clé API. Pour empêcher l'utilisation d'une identité CloudWatch Enregistre les clés d'API, joint une politique qui refuse logs:CallWithBearerToken action à l'attention de l'utilisateur IAM associé à la clé.

Exemples de politiques

Empêcher la génération et l'utilisation d'une identité CloudWatch Consigne les clés d'API

{ "Version": "2012-10-17", "Statement": [ { "Sid": "DenyCWLAPIKeys", "Effect": "Deny", "Action": [ "iam:CreateServiceSpecificCredential", "logs:CallWithBearerToken" ], "Resource": "*" } ] }
Avertissement

Cette politique empêchera la création d'informations d'identification pour tous AWS services qui prennent en charge la création d'informations d'identification spécifiques à un service. Pour plus d'informations, voir Service-specific informations d'identification pour les utilisateurs IAM.

Empêcher l'utilisation d'une identité CloudWatch Consigne les clés d'API

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "logs:CallWithBearerToken", "Resource": "*" } ] }

Autoriser la création de CloudWatch Enregistre les clés uniquement si elles expirent dans les 90 jours

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:CreateServiceSpecificCredential", "Resource": "arn:aws:iam::123456789012:user/username", "Condition": { "StringEquals": { "iam:ServiceSpecificCredentialServiceName": "logs.amazonaws.com" }, "NumericLessThanEquals": { "iam:ServiceSpecificCredentialAgeDays": "90" } } } ] }

Rotation des clés d’API

La rotation régulière de vos clés d’API réduit le risque d’accès non autorisé. Nous vous recommandons d'établir un calendrier de rotation conforme aux politiques de sécurité de votre organisation.

Processus de rotation

Pour alterner une clé API sans interrompre la livraison du journal, procédez comme suit :

  1. Créez de nouvelles informations d’identification (secondaires) pour l’utilisateur IAM :

    aws iam create-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-name logs.amazonaws.com \ --credential-age-days 90
  2. (Facultatif) Enregistrez les nouvelles informations d'identification dans AWS Secrets Manager pour une récupération sécurisée et une rotation automatique.

  3. Importez les nouvelles informations d'identification dans le portail de votre fournisseur ou mettez à jour la configuration de votre application pour utiliser la nouvelle clé API.

  4. Définissez les informations d’identification d’origine comme inactives :

    aws iam update-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-specific-credential-id ACCA1234EXAMPLE1234 \ --status Inactive
  5. Vérifiez que la livraison des journaux n'est pas affectée en surveillant IncomingBytes métrique pour votre groupe de journaux dans CloudWatch. Pour plus d'informations, voir Surveillance avec CloudWatch indicateurs.

  6. Après avoir confirmé la transmission avec la nouvelle clé, supprimez les informations d’identification précédentes :

    aws iam delete-service-specific-credential \ --service-specific-credential-id ACCA1234EXAMPLE1234

Surveillance de l’expiration des clés

Pour vérifier la date de création et le statut de vos clés d’API existantes, utilisez la commande list-service-specific-credentials :

aws iam list-service-specific-credentials \ --user-name cloudwatch-logs-hlc-user \ --service-name logs.amazonaws.com

La réponse inclut CreateDate et Status pour chaque ensemble d’informations d’identification. Utilisez ces informations pour identifier les clés qui approchent de leur expiration ou qui sont actives depuis plus longtemps que ne l’autorise votre politique de rotation.

Réaction à la compromission d’une clé d’API

Si vous soupçonnez la compromission d’une clé d’API, prenez immédiatement les mesures suivantes :

  1. Désactivez immédiatement la clé pour empêcher toute nouvelle utilisation non autorisée :

    aws iam update-service-specific-credential \ --user-name cloudwatch-logs-hlc-user \ --service-specific-credential-id ACCA1234EXAMPLE1234 \ --status Inactive
  2. Révision CloudTrail journaux pour déterminer l'étendue des accès non autorisés. Consultez Enregistrement de l'utilisation de la clé API avec CloudTrail pour savoir comment activer l’audit de l’utilisation des clés d’API.

  3. Créez une clé de remplacement en suivant le processus de rotation décrit dans Processus de rotation.

  4. Supprimez la clé compromise une fois la clé de remplacement en place :

    aws iam delete-service-specific-credential \ --service-specific-credential-id ACCA1234EXAMPLE1234
  5. Attachez une politique de refus si vous devez bloquer immédiatement tout accès par jeton porteur de l’utilisateur IAM pendant votre investigation :

    { "Version": "2012-10-17", "Statement": { "Effect": "Deny", "Action": "logs:CallWithBearerToken", "Resource": "*" } }
Note

Pour effectuer ces actions via l'API, vous devez vous authentifier auprès de AWS informations d'identification et non avec un CloudWatch Enregistre la clé API.

Vous pouvez également utiliser les opérations d’API IAM suivantes pour gérer les clés compromises :

  • ResetServiceSpecificCredential — Réinitialisez la clé pour générer un nouveau mot de passe sans supprimer les informations d'identification. La clé ne doit pas avoir expiré.

Bonnes pratiques de sécurité pour les clés d’API

Suivez ces bonnes pratiques pour protéger votre CloudWatch Consigne les clés d'API :

  • N’intégrez jamais de clés d’API dans le code source. Ne codez pas en dur les clés d'API dans le code de l'application et ne les validez pas dans les systèmes de contrôle de version. Si une clé est accidentellement validée dans un dépôt public, AWS le scan automatique peut le signaler et vous devez immédiatement tourner la touche.

  • Utilisez un gestionnaire de secrets. Stockez les clés d'API dans AWS Secrets Manager ou une solution de gestion de secrets équivalente. Cela permet un contrôle d’accès centralisé, une journalisation d’audit et une rotation automatique.

  • Définissez une expiration pour toutes les clés. Spécifiez toujours une valeur --credential-age-days lors de la création des clés d’API. Pour imposer une durée de vie maximale des clés dans votre organisation, utilisez la clé de condition IAM iam:ServiceSpecificCredentialAgeDays. Pour obtenir un exemple, consultez Autoriser la création de CloudWatch Enregistre les clés uniquement si elles expirent dans les 90 jours.

  • Appliquez les autorisations de moindre privilège. Étendez les autorisations de l'utilisateur IAM aux seuls groupes de journaux et aux actions requises. Utilisez le gestionnaire CloudWatchLogsAPIKeyAccess la politique comme point de départ et la restreindre davantage si nécessaire.

  • Activer CloudTrail journalisation. Auditez l'utilisation des clés d'API en activant CloudTrail événements de données pour AWS::Logs::LogGroupAuthorization. Consultez Enregistrement de l'utilisation de la clé API avec CloudTrail.

  • Surveillez avec IAM Access Analyzer. Utilisez IAM Access Analyzer pour identifier les informations d’identification inutilisées et les politiques trop permissives associées à vos utilisateurs IAM de clés d’API.

  • Effectuez régulièrement la rotation des clés. Établissez un calendrier de rotation et suivez le processus décrit dans Rotation des clés d’API.

Enregistrement de l'utilisation de la clé API avec CloudTrail

Vous pouvez utiliser AWS CloudTrail pour enregistrer les événements liés aux données pour CloudWatch Consigne l'utilisation de la clé API. CloudWatch Journalise les émissions AWS::Logs::LogGroupAuthorization événements de données pour CallWithBearerToken appels, vous permettant de vérifier quand et comment les clés d'API sont utilisées pour envoyer des journaux.

Pour activer CloudTrail journalisation pour CloudWatch Consigne l'utilisation des clés d'API :

Note

Le compartiment S3 que vous spécifiez pour le trail doit disposer d'une politique de compartiment qui permet CloudTrail pour y écrire des fichiers journaux. Pour plus d'informations, voir Politique relative aux compartiments Amazon S3 pour CloudTrail.

  1. Créez une piste :

    aws cloudtrail create-trail \ --name cloudwatch-logs-api-key-audit \ --s3-bucket-name my-cloudtrail-bucket \ --region us-east-1
  2. Configurer des sélecteurs d'événements avancés pour capturer CloudWatch Consigne les événements d'autorisation des groupes de journaux :

    aws cloudtrail put-event-selectors \ --region us-east-1 \ --trail-name cloudwatch-logs-api-key-audit \ --advanced-event-selectors '[{ "Name": "CloudWatch Logs API key authorization events", "FieldSelectors": [ { "Field": "eventCategory", "Equals": ["Data"] }, { "Field": "resources.type", "Equals": ["AWS::Logs::LogGroupAuthorization"] } ] }]'
  3. Démarrez la journalisation de la piste :

    aws cloudtrail start-logging \ --name cloudwatch-logs-api-key-audit \ --region us-east-1