Pour vous connecter à Autonomous Database, vous pouvez télécharger un fichier de connexion à partir de l'instance Database Actions et l'importer dans l'extension Google Sheet que vous avez configurée.

Dans cette section, vous utilisez l'interface utilisateur Web pour obtenir les éléments client_id et client_secret.

Vous générez les clés client en accédant à l'URL d'instance Autonomous Database ajoutée avec oauth/clients.

Par exemple, si votre instance est " https ://<nom_hôte>-<nom_databas>.adb.<région>.oraclecloudapps.com/ords/<nom_schéma>/_sdw/", vous devez vous connecter au lien " https ://<nom_hôte>-<nom_databas>.adb.<région>.oraclecloudapps.com/ords/<nom_schéma>/oauth/clients/". Veillez à inclure la barre oblique de fin.

1. Connectez-vous à Database Actions à l'aide du lien "https://machinename.oraclecloudapps.com/ords/SchemaName/oauth/clients/". Vous pouvez afficher une page Clients OAuth en cliquant sur le lien "https ://localhost:port/ords/schemaName/_sdw/ ?nav=rest-workshop&rest-workshop=oauth-clients".
2. Cliquez sur le bouton Client +Create OAuth pour créer un client.
   
   Description de l'illustration create-client.png
   
3. Dans la liste déroulante Type d'octroi, sélectionnez le type de connexion client souhaité. Vous pouvez sélectionner les options suivantes 
   • AUTH_CODE : sélectionnez cette option de connexion implicite. Utilisez ce type de réponse lorsque la base de données autonome se trouve dans un sous-réseau privé ou dans un pare-feu client.
   • IMPLICIT : sélectionnez cette option en vue d'une connexion explicite. Il s'agit de la méthode la plus sécurisée. Elle est préférable d'utiliser si la base de données autonome dispose d'un accès public.
4. Entrez les informations suivantes . Les champs accompagnés d'un astérisque (*) sont obligatoires :
   • Nom : nom du client.
   • Description : description de l'objectif du client.
   • URI de réacheminement : URL de déploiement d'application Web que vous avez copiée à partir de l'étape 10 de Déploiement du script Google en tant qu'application Web
   • URI du support : entrez l'URI dans lequel les utilisateurs finals peuvent contacter le client pour obtenir de l'aide. Exemple : https://script.google.com/
   • Adresse électronique du support technique : entrez l'adresse électronique à laquelle les utilisateurs finals peuvent contacter le client pour obtenir de l'aide.
   • Logo : vous pouvez éventuellement sélectionner une image de votre système local pour insérer un logo pour votre nouveau client.
   Accédez à l'onglet Rôles pour sélectionner les rôles du client. Ce champ n'est pas obligatoire.
5. Accédez à l'onglet Origines autorisées. Indiquez et ajoutez la liste des préfixes d'URL dans le champ de texte. Ce champ n'est pas obligatoire.
6. Accédez à l'onglet Privilèges pour ajouter des privilèges. Vous n'avez pas besoin de disposer de privilèges pour créer un client OAuth.
7. Cliquez sur Créer pour créer le client OAuth. Il enregistre le client OAuth que vous pouvez afficher sur la page Clients OAuth.
   
   Description de l'illustration new-client.png
   
8. Cliquez sur l'icône Afficher pour afficher les champs Client ID et Client Secret.

Comment me connecter manuellement ?

Les sections suivantes montrent comment se connecter à l'aide de connexions implicites et explicites. Google Sheets a besoin d'une autorisation pour accéder à Autonomous Database. Vous devez d'abord terminer l'autorisation de connexion à la base de données autonome. Le module nécessite une authentification unique pour la configuration.

1. Dans la feuille Google, cliquez sur Oracle Autonomous Database et sélectionnez Connexions.
   La sélection de Connexions nécessite une authentification Google unique.

   • Cliquez sur Connexions pour ouvrir une fenêtre contextuelle dans laquelle vous devez être autorisé à exécuter l'autorisation. Cliquez sur Continuer.
     
     Description de l'illustration auth-continue.png
     
   • Vous allez maintenant voir une fenêtre qui vous informe que l'application demande l'accès à des informations sensibles dans votre compte Google.
   • Cliquez sur Avancé et sélectionnez le lien Accéder au projet sans titre (non sécurisé). La sélection du lien ouvre une nouvelle fenêtre, vous assurant que vous faites confiance à l'application. Cliquez sur Autoriser pour continuer. Vous avez terminé la configuration.
2. Dans l'assistant Connexions, cliquez sur Ajouter une connexion dans le menu déroulant Gérer les connexions pour ajouter une connexion.
   
   Description de l'illustration add-connection.png
   
3. La sélection de l'option Ajouter une connexion ouvre un assistant Ajouter une connexion dans le panneau de liste des connexions de l'assistant Connexions.
   
   Description de l'illustration add-connection-fields.png
   

4. Indiquez les valeurs de champ suivantes dans l'assistant :

   Nom de connexion : entrez le nom de la connexion, par exemple, TestConnection.

   URL d'Autonomous Database : entrez l'URL de la base de données Autonomous Database à laquelle vous souhaitez vous connecter. Par exemple, "https ://<nom_hôte>-<nom_databas>.adb.<région>.oraclecloudapps.com/"

   Dans le champ OAuth Client Grant Type, sélectionnez l'une des deux options en fonction du type de connexion souhaité. Reportez-vous à la section Générer un ID client et une clé secrète client à l'aide de l'interface utilisateur.

   Cette option varie en fonction des connexions implicites et explicites.

   Implicite : sélectionnez cette option en vue d'une connexion implicite. Utilisez ce type de réponse lorsque la base de données autonome se trouve dans un sous-réseau privé ou dans un pare-feu client.

   AUTH_CODE : sélectionnez cette option dans le cas d'une connexion explicite. Il s'agit de la méthode la plus sûre et préférée à utiliser.

   Lorsque vous sélectionnez l'option Implicite, vous pouvez afficher les champs suivants :
   
   Description de l'illustration implicit.png
   

   OAuth ID client : client_id vous générez à l'aide de l'assistant Créer un client de l'interface utilisateur. Reportez-vous à la section Générer un ID client et une clé secrète client à l'aide de l'interface utilisateur.

   Nom de schéma : indiquez le nom du schéma.

   Lorsque vous sélectionnez AUTH_CODE, vous pouvez afficher les champs suivants :

   
   
   Description de l'image explicit.png
   

   OAuth ID client : client_id vous générez à l'aide de l'assistant Créer un client dans l'interface utilisateur. Reportez-vous à la section Générer un ID client et une clé secrète client à l'aide de l'interface utilisateur.

   OAuth Clé secrète client : client_secret que vous générez à l'aide de l'assistant Créer un client dans l'interface utilisateur. Reportez-vous à la section Générer un ID client et une clé secrète client à l'aide de l'interface utilisateur.

   Nom de schéma : indiquez le nom du schéma.

   Cliquez sur Enregistrer.

   Une fois que vous avez cliqué sur Enregistrer, vous pouvez visualiser la nouvelle connexion dans le panneau de liste des connexions. La liste des connexions affiche le nom de la connexion, le nom du schéma et le type OAuth que vous accordez. Cependant, il est toujours dans un état déconnecté.

5. Cliquez sur les trois points verticaux en regard du nom de la connexion et effectuez les opérations suivantes :

   Connexion : sélectionnez Connexion à l'instance Autonomous Database et définissez le statut de connexion sur Actif. Si vous sélectionnez Connexion, la page de connexion de la base de données autonome s'ouvre. Une fois connecté, vous verrez une page indiquant que l'accès à la base de données vous a été accordé. Fermez la fenêtre et revenez à Google Sheets. Vous verrez maintenant que la connexion est active.

   Modifier : sélectionnez Modifier pour mettre à jour toute valeur de la connexion. Pour mettre à jour les valeurs modifiées, cliquez sur Enregistrer.

   Dupliquer : sélectionnez Dupliquer pour créer une connexion en double.

   Enlever : sélectionnez Enlever pour enlever la connexion de la liste des connexions.

Export de connexions

1. Cliquez sur Exporter la connexion dans le menu déroulant Gérer les connexions pour exporter la connexion sélectionnée.
2. Sélectionnez la connexion à exporter, puis cliquez sur Exporter.
   
   Description de l'illustration export.png
   
3. Cliquez sur Exporter.

4. Les téléchargements de connexion exportés dans votre système local. Le fichier de connexion est enregistré en tant que spreadsheet_addin_connections.json.

Une fois votre identité déterminée à l'aide de l'authentification OAuth, Google Sheets doit disposer des droits d'accès à Autonomous Database.

Les valeurs client_id et client_secret que vous générez lors de l'authentification OAuth sont utilisées pour l'autorisation.

1. Cliquez sur le menu Oracle Autonomous Database dans la feuille Google sur laquelle vous travaillez, puis sélectionnez S'inscrire. Cela nécessite une authentification Google unique.
2. Cliquez sur Enregistrer pour ouvrir une fenêtre contextuelle qui vous demande l'autorisation d'exécuter l'autorisation. Cliquez sur Continuer. Si vous sélectionnez Continuer, vous serez redirigé vers la page Comptes Google, où vous devez sélectionner votre compte Gmail.
3. Vous allez maintenant voir une fenêtre qui vous informe que l'application demande l'accès à des informations sensibles dans votre compte Google. Cliquez sur Avancé et sélectionnez le lien Accéder au projet sans titre (non sécurisé).
4. La sélection du lien ouvre une nouvelle fenêtre pour vous assurer que vous faites confiance à l'application. Cliquez sur Autoriser pour continuer.
5. Vous avez terminé la configuration. Sélectionnez Inscrire dans le menu Oracle Autonomous Database de la feuille Google.
   Un assistant Oracle Autonomous Database s'ouvre dans la feuille Google. Remplissez les champs suivants :

   • URL ADB : entrez l'URL ADB. Par exemple, "https ://<nom_hôte>-<nom_databas>.adb.<région>.oraclecloudapps.com/ords/<nom_schéma>".
   • OAuth ID client : client_id généré lors de l'authentification.
   • OAuth : clé secrète client : client_secret que vous générez lors de l'authentification. Pour plus de détails, reportez-vous à la section Créer des connexions avec la feuille de calcul Google.
   
   
   Description de l'image adb-google-wizard.png
   
6. Sélectionnez Autoriser.

After successfully authorizing the credentials, you can view Connections, Direct SQL, Data Analysis, Analyses and Reports Clear Sheet, Delete All Sheets, About Autonomous Database, and Sign Out menu items under Oracle Autonomous Database.