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.
# Activation d’une extension publique tierce dans votre compte
La rubrique suivante vous explique comment activer une extension publique tierce dans votre compte, ce qui la rend utilisable dans le compte et la région où elle a été activée.
**Note**
Avant de poursuivre, assurez-vous d’avoir créé l’extension [Rôle IAM](registry-public.md#registry-public-enable-execution-role) que vous utiliserez.
**Topics**
+ [Activation d’une extension publique (console)](#registry-public-activate-extension-console)
+ [Activer une extension publique (AWS CLI)](#registry-public-activate-extension-cli)
## Activation d’une extension publique (console)
Suivez les étapes de cette section pour utiliser la console afin de :
+ Activation d’une extension publique tierce
+ Spécifiez des données de configuration d’extension supplémentaires pour votre compte
**Pour activer une extension publique à utiliser dans votre compte**
1. Connectez-vous à la CloudFormation console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)
1. Dans la barre de navigation, en haut de l’écran, sélectionnez votre Région AWS.
1. Dans le volet de navigation, sous **Registre**, sélectionnez **Extensions publiques**.
1. Utilisez le **filtre** pour choisir le type d’extension, puis sélectionnez **Tiers**. (Les extensions publiées par AWS sont activées par défaut.)
1. Sélectionnez l’extension, puis choisissez **Activer**.
Si plusieurs versions d’une extension sont disponibles, vous pouvez utiliser le menu **Version** pour choisir la version de l’extension que vous souhaitez activer. La version par défaut est la plus actuelle.
1. Pour le **nom de l’extension**, vous pouvez soit conserver l’option **Utiliser la valeur par défaut**, soit choisir **Remplacer la valeur par défaut**, puis saisir le type d’extension que vous souhaitez utiliser avec cette extension. L'alias doit respecter le format recommandé pour le type d'extension. Pour de plus amples informations, veuillez consulter [Utilisez des alias pour faire référence aux extensions](registry-public.md#registry-public-enable-alias).
1. Si l'extension que vous activez est un Hook ou un type de ressource, pour **l'ARN du rôle d'exécution**, spécifiez le rôle IAM CloudFormation à assumer lors de l'appel de l'extension. Pour de plus amples informations, veuillez consulter [Configurer un rôle d’exécution avec des autorisations IAM et une politique de confiance pour l’accès public aux extensions](registry-public.md#registry-public-enable-execution-role).
1. Pour la **configuration de la journalisation**, spécifiez les informations de configuration de la journalisation pour une extension, si vous le souhaitez. Par exemple :
```
{
"logRoleArn": "arn:aws:iam::account:role/rolename",
"logGroupName": "log-group-name"
}
```
Les informations de configuration de la journalisation ne sont pas requises, mais recommandées à des fins de débogage. Pour utiliser la configuration de la journalisation avec des hooks, ajoutez la même politique d’approbation que le rôle d’exécution spécifié, afin que le rôle du journal puisse écrire des journaux dans votre groupe de journaux.
`logRoleArn` et `logGroupName` les noms de clés sont sensibles à la casse.
1. Pour la **gestion des versions**, **Mises à jour automatiques**, choisissez le mode de réception des mises à jour.
+ **On** (Activé) : met automatiquement à jour vers la dernière version mineure. Les versions majeures sont mises à jour manuellement.
+ **On** (Désactivé) : ne met jamais automatiquement à jour vers la dernière version. Toutes les versions sont mises à jour manuellement.
Pour de plus amples informations, veuillez consulter [Utiliser automatiquement les nouvelles versions des extensions](registry-public.md#registry-public-enable-auto).
Si l’extension nécessite une configuration supplémentaire, vous avez la possibilité de spécifier les données de configuration maintenant ou après l’activation de l’extension.
**Important**
Si l’extension que vous activez est un Hook, cette étape est obligatoire. Vous devez spécifier `ENABLED` pour la propriété `HookInvocationStatus`. Cette opération active les propriétés du hook définies dans la section `properties` de schéma du hook. Pour plus d’informations, consultez la [référence de syntaxe du schéma de configuration Hook](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hook-configuration-schema.html) dans le *guide de l’utilisateur de Hooks CloudFormation *.
**Pour spécifier les données de configuration**
1. Pour **Configuration**, choisissez **Configurer maintenant**, puis sélectionnez **Activer l’extension**.
CloudFormation affiche la page **Configurer l'extension**. Pour afficher le schéma de configuration actuel de l'extension, assurez-vous d'activer **View configuration schema** (Afficher le schéma de configuration).
1. Dans la zone de texte **Fichier JSON de configuration**, saisissez une chaîne JSON qui représente les données de configuration que vous souhaitez spécifier pour cette extension. Le JSON que vous spécifiez doit être validé par rapport au schéma de configuration de l’extension.
1. Sélectionnez **Configurer l’extension**.
Si vous préférez configurer l’extension après l’activation, vous pouvez ignorer cette étape et fournir les données de configuration ultérieurement.
1. Pour **Configuration**, choisissez **Configurer ultérieurement**, puis sélectionnez **Activer l’extension**.
1. Une fois l’extension activée, vous pouvez la configurer en accédant à la page des extensions activées et en fournissant les données de configuration.
## Activer une extension publique (AWS CLI)
Suivez les étapes décrites dans cette section pour utiliser le AWS CLI pour :
+ Activation d’une extension publique tierce
+ Spécifiez des données de configuration d’extension supplémentaires pour votre compte
### Activation des Hooks publics
En activant les Hooks dans votre compte, vous autorisez un Hook à utiliser les autorisations définies par votre Compte AWS. CloudFormation supprime les autorisations non requises avant de les transmettre au Hook. CloudFormationrecommande aux clients ou aux utilisateurs de Hook de consulter les autorisations Hook et de connaître les autorisations auxquelles les Hooks sont autorisés avant d'activer Hooks dans votre compte.
**Pour activer un Hook public à utiliser dans votre compte (AWS CLI)**
1. Obtenez l’ARN pour votre Hook et enregistrez-le. Vous pouvez obtenir l'ARN d'un Hook en utilisant le AWS Management Console ou AWS CLI. Pour de plus amples informations, veuillez consulter [Afficher les extensions disponibles et activées dans le CloudFormation registre](registry-view.md).
```
export HOOK_TYPE_ARN="arn:aws:cloudformation:us-west-2:123456789012:type/hook/Organization-Service-Hook/"
```
1. Utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html) pour spécifier les données de configuration. Le JSON que vous transmettez à `--configuration` doit être validé par rapport au schéma de configuration du Hook. Pour activer le Hook pour toutes les opérations de stack, vous devez définir la propriété `HookInvocationStatus` sur `ENABLED` dans la section `HookConfiguration`.
```
aws cloudformation set-type-configuration \
--configuration "{"CloudFormationConfiguration":{"HookConfiguration":{"HookInvocationStatus": "ENABLED", "FailureMode": "FAIL", "Properties":{}}}}" \
--type-arn $HOOK_TYPE_ARN --region us-west-2
```
Pour plus d’informations sur les options de configuration `HookConfiguration`, consultez la [référence de syntaxe du schéma de configuration Hook](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hook-configuration-schema.html#) dans le *Guide de l’utilisateur de Hooks CloudFormation *.
### Activer les modules publics et les types de ressources
**Pour activer une extension publique à utiliser dans votre compte (AWS CLI)**
+ Utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/activate-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/activate-type.html) pour activer l’extension et spécifier s’il faut la mettre à jour chaque fois qu’une nouvelle version mineure de l’extension est publiée.
L'exemple ci-dessous spécifie l'Amazon Resource Name (ARN) public d'une extension publique à activer pour ce compte. En outre, il précise que l'extension est CloudFormation mise à jour chaque fois qu'une nouvelle version mineure est publiée.
```
aws cloudformation activate-type \
--public-type-arn public_extension_ARN \
--execution-role-arn arn:aws:iam::123456789012:role/my-execution-role \
--auto-update true --region us-west-2
```
Cette commande renvoie un ARN de l’extension activée.
```
{
"Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Resource-Example"
}
```
### Mettre à jour la version d’une extension publique (AWS CLI)
Utilisez [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/activate-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/activate-type.html) pour réactiver l'extension.
Utilisez cette option `--version-bump` pour spécifier si vous souhaitez mettre à jour l’extension vers la dernière version `MAJOR` ou la version `MINOR` la plus récente.
```
aws cloudformation activate-type --type RESOURCE \
--type-name Example::Test::1234567890abcdef0 \
--type-name-alias Example::Test::Alias \
--version-bump MAJOR --region us-west-2
```