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.
# Création d’un proxy pour Amazon RDS
Vous pouvez employer un proxy avec une instance de base de données RDS for MariaDB, RDS for Microsoft SQL Server, RDS for MySQL ou RDS pour PostgreSQL.
## Console
**Pour créer un proxy**
1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.
1. Dans le panneau de navigation, sélectionnez **Proxies**.
1. Choisissez **Création d’un proxy**.
1. Configurez les paramètres suivants pour votre proxy.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/rds-proxy-creating.html)
1. Choisissez **Création d’un proxy**.
## AWS CLI
Pour créer un proxy à l'aide de AWS CLI, appelez la commande [create-db-proxy](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-proxy.html) avec les paramètres obligatoires suivants :
+ `--db-proxy-name`
+ `--engine-family`
+ `--role-arn`
+ `--vpc-subnet-ids`
La valeur `--engine-family` est sensible à la casse.
**Example**
Pour Linux, macOS ou Unix :
```
aws rds create-db-proxy \
--db-proxy-name {{proxy_name}} \
--engine-family { MYSQL | POSTGRESQL | SQLSERVER } \
--role-arn {{iam_role}} \
--vpc-subnet-ids {{space_separated_list}} \
[--default-auth-scheme { NONE | IAM_AUTH }] \
[--auth {{ProxyAuthenticationConfig_JSON_string}}] \
[--vpc-security-group-ids {{space_separated_list}}] \
[--require-tls | --no-require-tls] \
[--idle-client-timeout {{value}}] \
[--debug-logging | --no-debug-logging] \
[--endpoint-network-type { IPV4 | IPV6 | DUAL }] \
[--target-connection-network-type { IPV4 | IPV6 }] \
[--tags {{comma_separated_list}}]
```
Pour Windows :
```
aws rds create-db-proxy ^
--db-proxy-name {{proxy_name}} ^
--engine-family { MYSQL | POSTGRESQL | SQLSERVER } ^
--role-arn {{iam_role}} ^
--vpc-subnet-ids {{space_separated_list}} ^
[--default-auth-scheme { NONE | IAM_AUTH }] ^
[--auth {{ProxyAuthenticationConfig_JSON_string}}] ^
[--vpc-security-group-ids {{space_separated_list}}] ^
[--require-tls | --no-require-tls] ^
[--idle-client-timeout {{value}}] ^
[--debug-logging | --no-debug-logging] ^
[--endpoint-network-type { IPV4 | IPV6 | DUAL }] ^
[--target-connection-network-type { IPV4 | IPV6 }] ^
[--tags {{comma_separated_list}}]
```
Voici un exemple de valeur JSON pour l’option `--auth`. Cet exemple applique un type d’authentification client différent à chaque secret.
```
[
{
"Description": "proxy description 1",
"AuthScheme": "SECRETS",
"SecretArn": "arn:aws:secretsmanager:us-west-2:123456789123:secret/1234abcd-12ab-34cd-56ef-1234567890ab",
"IAMAuth": "DISABLED",
"ClientPasswordAuthType": "POSTGRES_SCRAM_SHA_256"
},
{
"Description": "proxy description 2",
"AuthScheme": "SECRETS",
"SecretArn": "arn:aws:secretsmanager:us-west-2:111122223333:secret/1234abcd-12ab-34cd-56ef-1234567890cd",
"IAMAuth": "DISABLED",
"ClientPasswordAuthType": "POSTGRES_MD5"
},
{
"Description": "proxy description 3",
"AuthScheme": "SECRETS",
"SecretArn": "arn:aws:secretsmanager:us-west-2:111122221111:secret/1234abcd-12ab-34cd-56ef-1234567890ef",
"IAMAuth": "REQUIRED"
}
]
```
Le paramètre `--endpoint-network-type` indique la version IP du point de terminaison de proxy que les clients utilisent pour se connecter au proxy. Les valeurs valides sont :
+ `IPV4` : le point de terminaison du proxy utilise uniquement des adresses IPv4 (par défaut).
+ `IPV6` : le point de terminaison du proxy utilise uniquement des adresses IPv6.
+ `DUAL` : le point de terminaison du proxy prend en charge les adresses IPv4 et IPv6.
Le paramètre `--target-connection-network-type` indique la version IP utilisée par le proxy pour se connecter à la base de données cible. Les valeurs valides sont :
+ `IPV4` : le proxy se connecte à la base de données à l’aide d’adresses IPv4 (par défaut).
+ `IPV6` : le proxy se connecte à la base de données à l’aide d’adresses IPv6.
Pour utiliser les types de réseaux de point de terminaison IPv6 ou à double pile, votre VPC et vos sous-réseaux doivent être configurés pour prendre en charge le type de réseau sélectionné. Pour utiliser le type de réseau de connexion cible IPv6, votre base de données doit prendre en charge le mode double pile.
**Astuce**
Si vous ne connaissez pas encore les ID de sous-réseaux à utiliser pour le paramètre `--vpc-subnet-ids`, consultez [Configuration des prérequis réseau pour un proxy RDS](rds-proxy-network-prereqs.md) pour des exemples qui vous aideront à les trouver ID.
**Note**
Le groupe de sécurité doit autoriser l’accès à la base de données à laquelle le proxy se connecte. Le même groupe de sécurité est utilisé pour l’entrée de vos applications vers le proxy, et pour la sortie du proxy vers la base de données. Par exemple, supposons que vous utilisiez le même groupe de sécurité pour votre base de données et votre proxy. Dans ce cas, assurez-vous de spécifier que les ressources de ce groupe de sécurité peuvent communiquer avec d’autres ressources du même groupe de sécurité.
Lorsque vous utilisez un VPC partagé, vous ne pouvez pas utiliser le groupe de sécurité par défaut pour le VPC ni un groupe appartenant à un autre compte. Choisissez un groupe de sécurité qui appartient à votre compte. S’il n’en existe aucun, créez-en un. Pour plus d’informations sur cette limitation, consultez [Utiliser des VPC partagés](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html#vpc-share-limitations).
Pour créer les associations requises pour le proxy, vous pouvez également utiliser la commande [register-db-proxy-targets](https://docs.aws.amazon.com/cli/latest/reference/rds/register-db-proxy-targets.html). Spécifiez le nom du groupe cible `default`. RDS Proxy crée automatiquement un groupe cible portant ce nom au moment de la création de chaque proxy.
```
aws rds register-db-proxy-targets
--db-proxy-name {{value}}
[--target-group-name {{target_group_name}}]
[--db-instance-identifiers {{space_separated_list}}] # rds db instances, or
[--db-cluster-identifiers {{cluster_id}}] # rds db cluster (all instances)
```
## API RDS
Pour créer un proxy RDS, appelez l’opération d’API Amazon RDS [CreateDBProxy](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBProxy.html). Vous transmettez un paramètre avec la structure [AuthConfig](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_AuthConfig.html)de données.
RDS Proxy crée automatiquement un groupe cible nommé `default` au moment de la création de chaque proxy. Vous associez un de données RDS au groupe cible en appelant la fonction [RegisterDBProxyTargets](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RegisterDBProxyTargets.html).
**Important**
Lorsque vous sélectionnez l'**authentification IAM comme** schéma d'authentification par défaut :
Vous devez activer l'authentification de base de données IAM sur vos instances ou clusters de base de données cibles pour que le proxy puisse se connecter correctement.
Si vous choisissez **Créer un rôle IAM**, le champ **Comptes de base de données pour l'authentification IAM** est obligatoire.
Si vous sélectionnez un rôle IAM existant, la console ne met pas automatiquement à jour le rôle avec les autorisations de connexion à la base de données. Vérifiez que le rôle dispose des `rds-db:connect` autorisations nécessaires.