

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configurazione di un client Kerberos e connessione all'istanza DB

Dopo aver completato i passaggi in [Configurazione di Active Directory autogestito](oracle-smad-setting-up.md), completa i passaggi seguenti per ogni istanza DB che desideri utilizzare con l'autenticazione Kerberos. È possibile aggiungere l'istanza DB al dominio, creare utenti Oracle per gli utenti di Active Directory (AD), configurare un client Kerberos e quindi connettersi all'istanza DB. Se un host client è già configurato per il tuo dominio, non è necessario ripetere la configurazione Kerberos nel passaggio 3 per un'altra istanza DB. Assicurati che l'host client possa raggiungere la nuova istanza DB tramite la porta del database.
+ [Fase 1: Creare o modificare un'istanza Amazon RDS per Oracle DB](#oracle-smad.connecting.step1)
+ [Fase 2: Creazione degli accessi Oracle per l'autenticazione Kerberos](#oracle-smad.connecting.step2)
+ [Fase 3: Configurazione di un client Kerberos](#oracle-smad.connecting.step3)
+ [Passaggio 4: connettiti alla tua istanza DB](#oracle-smad.connecting.step4)

## Fase 1: Creare o modificare un'istanza Amazon RDS per Oracle DB
<a name="oracle-smad.connecting.step1"></a>

Puoi aggiungere un'istanza Amazon RDS for Oracle DB al tuo dominio AD autogestito nei seguenti modi:
+ Crea una nuova istanza DB con la console, [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) AWS CLI comando o [istanza db creata](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) Funzionamento dell'API RDS. Per istruzioni, vedere [Creazione di un'istanza DB Amazon RDS](USER_CreateDBInstance.html).
+ Modifica un'istanza DB esistente con la console, [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) AWS CLI comando o [ModifyDB Instance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) Funzionamento dell'API RDS. Per istruzioni, vedere [Modifica di un'istanza DB di Amazon RDS](Overview.DBInstance.Modifying.html).
+ Ripristina un'istanza Oracle DB da un'istantanea DB utilizzando la console, [restore-db-instance-from-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html) AWS CLI comando o il [RestoreDBInstanceFromDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html) operazione API RDS. Per istruzioni, vedere [Ripristino su un'istanza DB](USER_RestoreFromSnapshot.html).
+ Ripristina un'istanza Oracle DB in un determinato momento utilizzando la console, [restore-db instance-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html) AWS CLI comando o il [RestoreDBInstanceToPointInTime](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html) operazione API RDS. Per istruzioni, vedere [Ripristino di un'istanza DB a un orario specificato per Amazon RDS](USER_PIT.html).
+ Crea una replica di lettura di un'istanza Oracle DB utilizzando la console, [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) AWS CLI comando o [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) operazione API RDS. Una replica di lettura non eredita l'appartenenza al dominio dell'origine, pertanto specifica i quattro parametri di dominio nell'operazione. Per istruzioni, consulta [Creazione di una replica letta](USER_ReadRepl.Create.html).

L'istanza DB deve trovarsi in un cloud privato virtuale (VPC) in grado di raggiungere i controller di dominio. Quando crei o modifichi l'istanza DB, assicurati che i suoi gruppi di sicurezza consentano il traffico descritto in [Configurazione della connettività di rete](oracle-smad-requirements.md#oracle-smad-requirements.configure-network).

### Utilizzo della console
<a name="oracle-smad.connecting.step1.console"></a>

1. Nel **Autenticazione del database** impostazioni della pagina di creazione, modifica, ripristino o creazione e lettura della replica, scegli **Password e autenticazione Kerberos**.

1. Per **Tipo di autenticazione Kerberos**, scegli **Self-managed Microsoft Active Directory**.

1. Immetti uno dei seguenti valori:
   + **Nome di dominio completo (FQDN)** — L'FQDN del tuo dominio, ad esempio `corp.example.com`.
   + **Unità organizzativa (UO)** — Il nome distinto dell'unità organizzativa creata nel passaggio 1 di [Configurazione di Active Directory autogestito](oracle-smad-setting-up.md), ad esempio `OU=AWS-RDS-OU,DC=corp,DC=example,DC=com`. Deve avere uno o più componenti OU seguiti da uno o più componenti DC e i valori dei componenti non possono contenere metacaratteri della shell $, `, \|,; o caratteri di controllo.
   + **ARN segreto di autorizzazione** — L'Amazon Resource Name (ARN) del segreto che hai creato nella fase 5 di [Configurazione di Active Directory autogestito](oracle-smad-setting-up.md).
   + **IP del server DNS primario** e **IP del server DNS secondario** — Gli indirizzi IPv4 dei server DNS per il tuo dominio.

1. Completa il resto della pagina e scegli **Crea database**, **Modifica l'istanza DB**, **Ripristina l'istanza DB**, o **Crea una replica di lettura**.

### Utilizzo di AWS CLI
<a name="oracle-smad.connecting.step1.cli"></a>

Quando si utilizza AWS CLI, i seguenti parametri sono necessari affinché l'istanza DB si unisca al dominio AD autogestito:
+ Per `--domain-fqdn`, usa il nome di dominio completo del tuo dominio.
+ Per `--domain-ou`, utilizza il nome distinto dell'unità organizzativa creata nel passaggio 1 di [Configurazione di Active Directory autogestito](oracle-smad-setting-up.md). Deve avere uno o più componenti OU seguiti da uno o più componenti DC e i valori dei componenti non possono contenere metacaratteri della shell $, `, \|,; o caratteri di controllo.
+ Per `--domain-auth-secret-arn`, usa l'ARN del segreto che hai creato nel passaggio 5 di [Configurazione di Active Directory autogestito](oracle-smad-setting-up.md).
+ Per `--domain-dns-ips`, utilizza gli indirizzi IPv4 primario e secondario dei server DNS per il tuo dominio. Questo parametro richiede esattamente due indirizzi. Se non disponi di un server DNS secondario, inserisci l'indirizzo principale due volte.

Ad esempio, il comando seguente unisce un'istanza DB esistente a un dominio AD autogestito.

Per Linux, macOS o 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"
```

Per 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"
```

Per verificare che l'unione al dominio sia avvenuta correttamente, esegui il comando seguente e confermalo `Status` è `kerberos-enabled`.

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

Se lo stato è `enable-kerberos-failed`, consultare [Risoluzione dei problemi relativi all'autogestione di Active Directory for Amazon RDS for Oracle](oracle-smad-troubleshooting.md).

## Fase 2: Creazione degli accessi Oracle per l'autenticazione Kerberos
<a name="oracle-smad.connecting.step2"></a>

Dopo che l'istanza DB ha raggiunto `kerberos-enabled`, utilizza le credenziali utente master di Amazon RDS per connetterti all'istanza Oracle DB come fai con qualsiasi altra istanza DB. L'istanza DB è aggiunta al tuo dominio AD autogestito, quindi puoi effettuare il provisioning degli accessi e degli utenti Oracle dagli utenti di Microsoft Active Directory nel tuo dominio. Per gestire autorizzazioni del database, concedi e revoca autorizzazioni Oracle standard a questi login.

**Per consentire a un utente di Microsoft Active Directory di autenticarsi con Oracle**

1. Per connetterti all’istanza database Oracle utilizza invece le credenziali dell'utente master Amazon RDS.

1. Crea un utente autenticato esternamente nel database Oracle. Nell'esempio seguente, sostituisci `KRBUSER@CORP.EXAMPLE.COM` con il nome utente e il nome di dominio.

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

1. Gli utenti (sia umani che applicazioni) del tuo dominio possono ora connettersi all'istanza Oracle DB da un computer client aggiunto al dominio utilizzando l'autenticazione Kerberos.

**Nota**  
Una replica di lettura è di sola lettura, quindi non è possibile creare utenti di database su di essa. Crea utenti identificati esternamente sull'istanza DB primaria. Amazon RDS li replica nella replica di lettura e gli utenti AD possono quindi connettersi alla replica di lettura con l'autenticazione Kerberos.  
Se una replica di lettura viene aggiunta a un dominio diverso da quello dell'istanza DB primaria, crea l'utente del database per l'entità del dominio della replica di lettura anche sull'istanza DB primaria. Sebbene tale utente non possa autenticarsi sull'istanza DB primaria, Amazon RDS replica l'utente sulla replica di lettura, dove l'utente può autenticarsi con Kerberos.

## Fase 3: Configurazione di un client Kerberos
<a name="oracle-smad.connecting.step3"></a>

Per configurare un client Oracle, devi rispettare i requisiti seguenti:
+ Crea un file di configurazione denominato `krb5.conf` (Linux, macOS o Unix) o `krb5.ini` (Windows) in modo che punti al dominio. Per utilizzare questo file di configurazione, configura il client Oracle.
+ Verifica che il traffico possa fluire tra l'host del client e i controller di dominio AD tramite la porta DNS 53 TCP/UDP, le porte Kerberos 88 e 464 su TCP e la porta LDAP 389 su TCP.
+ Verifica che il traffico scorra senza problemi tra l'host client e l'istanza database sulla porta del database.

Di seguito è riportato un esempio `krb5.conf` contenuto:

```
[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
```

Quanto segue è un esempio `sqlnet.ora` contenuto per una configurazione SQL\*Plus:

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

**Nota**  
Impostare `SQLNET.KERBEROS5_CONF_MIT=TRUE` in quello del cliente `sqlnet.ora` file quando il tuo `krb5.conf` il file utilizza il formato di configurazione MIT Kerberos, come nell'esempio precedente. Questo parametro consente al database di riconoscere il ticket Kerberos emesso dal MIT `kinit` memorizzato nella cache. Senza di essa, l'autenticazione fallisce anche se `kinit` ha ottenuto un biglietto valido. Per ulteriori informazioni su questo parametro, vedere [Parametri di autenticazione Kerberos, SSL e 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) e [Configurazione dell'autenticazione Kerberos](https://docs.oracle.com/cd/E15586_01/network.1111/e10746/asokerb.htm) nella documentazione del database Oracle.

**Suggerimento**  
Se si utilizza una cache nativa di Windows, è anche possibile impostare `SQLNET.KERBEROS5_CC_NAME` parametro a `OSMSFT://` o `MSLSA` nel `sqlnet.ora` file per utilizzare le credenziali archiviate in Microsoft Active Directory.

## Passaggio 4: connettiti alla tua istanza DB
<a name="oracle-smad.connecting.step4"></a>

**Per connettersi con SQL\*Plus**

1. Al prompt dei comandi, procuratevi un ticket Kerberos. Sostituisci `KRBUSER@CORP.EXAMPLE.COM` con l'utente e il nome di dominio AD e inserisci la password AD al prompt.

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

1. Apri SQL\*Plus ed esegui la connessione utilizzando il nome DNS e il numero di porta per l'istanza database Oracle. Per ulteriori informazioni sulla connessione a un'istanza Oracle DB in SQL\*Plus, vedere [Connessione all'istanza DB tramite SQL\*Plus](USER_ConnectToOracleInstance.SQLPlus.html).