

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 d'un client Kerberos et connexion à votre instance de base de données

Une fois que vous avez terminé les étapes de [Configuration d’Active Directory autogéré](oracle-smad-setting-up.md), effectuez les étapes suivantes pour chaque instance de base de données que vous souhaitez utiliser avec l'authentification Kerberos. Vous joignez l'instance de base de données à votre domaine, vous créez des utilisateurs Oracle pour vos utilisateurs Active Directory (AD), vous configurez un client Kerberos, puis vous vous connectez à l'instance de base de données. Si un hôte client est déjà configuré pour votre domaine, il n'est pas nécessaire de répéter sa configuration Kerberos à l'étape 3 pour une autre instance de base de données. Assurez-vous que l'hôte client peut accéder à la nouvelle instance de base de données via le port de base de données.
+ [Étape 1 : créer ou modifier une instance de base de données Amazon RDS pour Oracle](#oracle-smad.connecting.step1)
+ [Étape 2 : Création de connexions Oracle pour l'authentification Kerberos](#oracle-smad.connecting.step2)
+ [Étape 3 : Configuration d'un client Kerberos](#oracle-smad.connecting.step3)
+ [Étape 4 : connexion à votre instance de base de données](#oracle-smad.connecting.step4)

## Étape 1 : créer ou modifier une instance de base de données Amazon RDS pour Oracle
<a name="oracle-smad.connecting.step1"></a>

Vous pouvez joindre une instance de base de données Amazon RDS pour Oracle à votre domaine AD autogéré de la manière suivante :
+ Créez une nouvelle instance de base de données à l'aide de la console, la [créer une instance de base de données](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) AWS CLI commande, ou [Instance B créée](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) Fonctionnement de l'API RDS. Pour obtenir des instructions, voir [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.html).
+ Modifiez une instance de base de données existante à l'aide de la console, [modifier-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) AWS CLI commande, ou [Modifier l'instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) Fonctionnement de l'API RDS. Pour obtenir des instructions, voir [Modification d'une instance de base de données Amazon RDS](Overview.DBInstance.Modifying.html).
+ Restaurez une instance de base de données Oracle à partir d'un instantané de base de données à l'aide de la console, [restaurer l'instance de base de données à partir de l'instantané de base de données](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html) AWS CLI commande, ou [RestoreDBInstanceFromDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html) Fonctionnement de l'API RDS. Pour obtenir des instructions, voir [Restauration vers une instance de base de données](USER_RestoreFromSnapshot.html).
+ Restaurez une instance de base de données Oracle à un moment précis à l'aide de la console, [restaurer une instance de base de données à un point dans le temps](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html) AWS CLI commande, ou [RestoreDBInstanceToPointInTime](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html) Fonctionnement de l'API RDS. Pour obtenir des instructions, voir [Restauration d'une instance de base de données à une heure spécifiée pour Amazon RDS](USER_PIT.html).
+ Créez une réplique en lecture d'une instance de base de données Oracle à l'aide de la console, [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) AWS CLI commande, ou [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) Fonctionnement de l'API RDS. Un réplica en lecture n'hérite pas de l'appartenance au domaine de sa source. Spécifiez donc les quatre paramètres de domaine lors de l'opération. Pour obtenir des instructions, voir [Création d'une réplique de lecture](USER_ReadRepl.Create.html).

L'instance de base de données doit se trouver dans un cloud privé virtuel (VPC) pouvant atteindre vos contrôleurs de domaine. Lorsque vous créez ou modifiez l'instance de base de données, assurez-vous que ses groupes de sécurité autorisent le trafic décrit dans [Configuration de votre connectivité réseau](oracle-smad-requirements.md#oracle-smad-requirements.configure-network).

### Utilisation de la console
<a name="oracle-smad.connecting.step1.console"></a>

1. Dans le **Authentification des bases** paramètres de la page de création, de modification, de restauration ou de création de répliques en lecture, choisissez **Mot de passe et authentification Kerberos**.

1. Pour **Type d'authentification Kerberos**, choisissez **Self-managed Microsoft Active Directory**.

1. Entrez les valeurs suivantes :
   + **Nom de domaine complet (FQDN)** — Le nom de domaine complet de votre domaine, tel que `corp.example.com`.
   + **Unité organisationnelle (OU)** — Le nom distinctif de l'unité d'organisation que vous avez créée à l'étape 1 de [Configuration d’Active Directory autogéré](oracle-smad-setting-up.md), tels que `OU=AWS-RDS-OU,DC=corp,DC=example,DC=com`. Il doit comporter un ou plusieurs composants OU suivis d'un ou plusieurs composants DC, et les valeurs des composants ne peuvent pas contenir de métacaractères shell $, `, \|, ; ou de caractères de contrôle.
   + **ARN secret d'autorisation** — Le nom de ressource Amazon (ARN) du secret que vous avez créé à l'étape 5 de [Configuration d’Active Directory autogéré](oracle-smad-setting-up.md).
   + **IP du serveur DNS principal** et **IP du serveur DNS secondaire** — Les adresses IPv4 des serveurs DNS de votre domaine.

1. Complétez le reste de la page, puis choisissez **Créer une base de données**, **Modifier l'instance de base de données**, **Restaurer l'instance de base de**, ou **Créer une réplique de lecture**.

### Utilisation de AWS INTERFACE DE LIGNE DE COMMANDE (CLI)
<a name="oracle-smad.connecting.step1.cli"></a>

Lorsque vous utilisez le AWS CLI, les paramètres suivants sont requis pour que l'instance de base de données rejoigne votre domaine AD autogéré :
+ Pour `--domain-fqdn`, utilisez le nom de domaine complet de votre domaine.
+ Pour `--domain-ou`, utilisez le nom distinctif de l'unité d'organisation que vous avez créée à l'étape 1 de [Configuration d’Active Directory autogéré](oracle-smad-setting-up.md). Il doit comporter un ou plusieurs composants OU suivis d'un ou plusieurs composants DC, et les valeurs des composants ne peuvent pas contenir de métacaractères shell $, `, \|, ; ou de caractères de contrôle.
+ Pour `--domain-auth-secret-arn`, utilisez l'ARN du secret que vous avez créé à l'étape 5 de [Configuration d’Active Directory autogéré](oracle-smad-setting-up.md).
+ Pour `--domain-dns-ips`, utilisez les adresses IPv4 principale et secondaire des serveurs DNS de votre domaine. Ce paramètre prend exactement deux adresses. Si vous n'avez pas de serveur DNS secondaire, entrez deux fois l'adresse principale.

Par exemple, la commande suivante joint une instance de base de données existante à un domaine AD autogéré.

Pour Linux, macOS ou Unix :

```bash
aws rds modify-db-instance \
    --db-instance-identifier my-oracle-instance \
    --domain-fqdn corp.example.com \
    --domain-ou "OU=AWS-RDS-OU,DC=corp,DC=example,DC=com" \
    --domain-auth-secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:my-ad-secret-AbCdEf" \
    --domain-dns-ips "10.0.1.100" "10.0.1.101"
```

Pour Windows :

```
aws rds modify-db-instance ^
    --db-instance-identifier my-oracle-instance ^
    --domain-fqdn corp.example.com ^
    --domain-ou "OU=AWS-RDS-OU,DC=corp,DC=example,DC=com" ^
    --domain-auth-secret-arn "arn:aws:secretsmanager:us-west-2:123456789012:secret:my-ad-secret-AbCdEf" ^
    --domain-dns-ips "10.0.1.100" "10.0.1.101"
```

Pour vérifier que la jointure de domaine a réussi, exécutez la commande suivante et confirmez que `Status` est `kerberos-enabled`.

```bash
aws rds describe-db-instances \
    --db-instance-identifier my-oracle-instance \
    --query 'DBInstances[0].DomainMemberships'
```

Si l’état est `enable-kerberos-failed`, consultez [Résolution des problèmes liés à Active Directory autogéré pour Amazon RDS pour Oracle](oracle-smad-troubleshooting.md).

## Étape 2 : Création de connexions Oracle pour l'authentification Kerberos
<a name="oracle-smad.connecting.step2"></a>

Une fois que l'instance de base de données a atteint `kerberos-enabled`, utilisez les informations d'identification de l'utilisateur principal Amazon RDS pour vous connecter à l'instance de base de données Oracle comme vous le faites pour n'importe quelle autre instance de base de données. L'instance de base de données est jointe à votre domaine AD autogéré, de sorte que vous pouvez provisionner les connexions et les utilisateurs Oracle à partir des utilisateurs Microsoft Active Directory de votre domaine. Pour gérer les autorisations de base de données, vous pouvez octroyer et annuler les autorisations Oracle standard pour ces connexions.

**Pour autoriser un utilisateur de Microsoft Active Directory à s'authentifier auprès d'Oracle**

1. Connectez l'instance de base de données Oracle à l'aide de vos informations d'identification de l'utilisateur principal Amazon RDS.

1. Créez un utilisateur authentifié en externe dans la base de données Oracle. Dans l'exemple suivant, remplacez `KRBUSER@CORP.EXAMPLE.COM` par le nom d'utilisateur et le nom de domaine.

   ```sql
   CREATE USER "KRBUSER@CORP.EXAMPLE.COM" IDENTIFIED EXTERNALLY;
   GRANT CREATE SESSION TO "KRBUSER@CORP.EXAMPLE.COM";
   ```

1. Les utilisateurs (humains et applications) de votre domaine peuvent désormais se connecter à l'instance de base de données Oracle à partir d'un ordinateur client joint au domaine à l'aide de l'authentification Kerberos.

**Note**  
Un réplica en lecture est en lecture seule, vous ne pouvez donc pas y créer d'utilisateurs de base de données. Créez des utilisateurs identifiés de manière externe sur l'instance de base de données principale. Amazon RDS les réplique dans la réplique en lecture, et vos utilisateurs AD peuvent ensuite se connecter à la réplique en lecture avec l'authentification Kerberos.  
Si un réplica de lecture est joint à un domaine différent de celui de l'instance de base de données principale, créez également l'utilisateur de base de données pour le principal de domaine du réplica de lecture sur l'instance de base de données principale. Bien que cet utilisateur ne puisse pas s'authentifier sur l'instance de base de données principale, Amazon RDS le réplique vers le réplica en lecture, où il peut s'authentifier auprès de Kerberos.

## Étape 3 : Configuration d'un client Kerberos
<a name="oracle-smad.connecting.step3"></a>

Pour configurer un client Oracle, vous devez vous conformer aux exigences suivantes :
+ Créez un fichier de configuration nommé `krb5.conf` (Linux, macOS ou Unix) ou `krb5.ini` (Windows) pour pointer vers le domaine. Configurez le client Oracle pour qu'il utilise ce fichier de configuration.
+ Vérifiez que le trafic peut circuler entre l'hôte client et vos contrôleurs de domaine AD via le port DNS 53 TCP/UDP, les ports Kerberos 88 et 464 via TCP et le port LDAP 389 via TCP.
+ Vérifiez que le trafic peut circuler entre l’hôte du client et l’instance de base de données via le port de la base de données.

Ce qui suit est un exemple `krb5.conf` contenu :

```
[libdefaults]
 default_realm = CORP.EXAMPLE.COM

[realms]
 CORP.EXAMPLE.COM = {
  kdc = corp.example.com
  admin_server = corp.example.com
 }

[domain_realm]
 .corp.example.com = CORP.EXAMPLE.COM
 corp.example.com = CORP.EXAMPLE.COM
```

Ce qui suit est un exemple `sqlnet.ora` contenu pour une configuration SQL\*Plus :

```
SQLNET.AUTHENTICATION_SERVICES=(KERBEROS5PRE,KERBEROS5)
SQLNET.KERBEROS5_CONF=path_to_krb5.conf_file
SQLNET.KERBEROS5_CONF_MIT=TRUE
```

**Note**  
Set `SQLNET.KERBEROS5_CONF_MIT=TRUE` chez le client `sqlnet.ora` fichier lorsque votre `krb5.conf` Le fichier utilise le format de configuration MIT Kerberos, comme le fait l'exemple précédent. Ce paramètre permet à la base de données de reconnaître le ticket Kerberos que le MIT `kinit` mis en cache. Sans elle, l'authentification échoue même si `kinit` a obtenu un billet valide. Pour plus d'informations sur ce paramètre, voir [Paramètres d'authentification Kerberos, SSL et RADIUS](https://docs.oracle.com/en/database/oracle/oracle-database/21/dbseg/kerberos-ssl-and-radius-authentication-parameters.html#GUID-34BAFC7C-4B29-4F52-90B6-4F6B93580250) et [Configuration de l'authentification Kerberos](https://docs.oracle.com/cd/E15586_01/network.1111/e10746/asokerb.htm) dans la documentation de la base de données Oracle.

**Astuce**  
Si vous utilisez un cache Windows natif, vous pouvez également définir `SQLNET.KERBEROS5_CC_NAME` paramètre pour `OSMSFT://` ou `MSLSA` dans le `sqlnet.ora` fichier pour utiliser les informations d'identification stockées dans Microsoft Active Directory.

## Étape 4 : connexion à votre instance de base de données
<a name="oracle-smad.connecting.step4"></a>

**Pour vous connecter à SQL\*Plus**

1. À l'invite de commande, obtenez un ticket Kerberos. Remplacer `KRBUSER@CORP.EXAMPLE.COM` avec l'utilisateur et le nom de domaine AD, puis entrez le mot de passe AD à l'invite.

   ```bash
   kinit KRBUSER@CORP.EXAMPLE.COM
   ```

1. Ouvrez SQL\*Plus et connectez-vous à l'aide du nom et du numéro de port DNS pour l'instance de base de données Oracle. Pour plus d'informations sur la connexion à une instance de base de données Oracle dans SQL\*Plus, consultez [Connexion à votre instance de base de données à l'aide de SQL\*Plus](USER_ConnectToOracleInstance.SQLPlus.html).