Autorisation du connecteur Coveo à accéder au Dropbox des membres de votre équipe
Le protocole OAuth (1.0 et 2.0) est un protocole qui est utilisé pour accorder l’accès aux applications externes sans exposer les véritables paramètres de connexion de l’utilisateur. Afin que le connecteur puisse pouvoir se connecter au Dropbox des membres de votre équipe, il doit acquérir une clé d’application, un secret d’application, un jeton d’accès et un secret de jeton d’accès pour utiliser le protocole OAuth 1.0 et seulement un jeton d’accès pour OAuth 2.0.
Afin d'autoriser le connecteur Coveo à accéder au Dropbox des membres de votre équipe
Note : Cette rubrique décrit une procédure qui utilise Google Chrome et l'extension Advanced Rest Client. Toutefois, elle peut être faite avec d'autres navigateurs et extensions, tels que Firefox et le plug-in RESTClient.
-
Créez une application dans un compte Dropbox for Business :
-
Connectez-vous au site web de Dropbox avec un compte d’administrateur.
-
Accédez à la page Create a new Dropbox for Business app.
-
Dans la page Create a new Dropbox for Business app :
-
Sous What type of app do you want to create?, cochez Team member file access.
-
Dans la boîte Provide an app name, and you're on your way, tapez un nom de votre choix qui décrit l'application.
Exemple : Coveo Business App
-
-
Dans la page [Your app name], selon le protocole d'authentification OAuth que vous souhaitez utiliser :
-
Lorsque vous souhaitez utiliser OAuth2 :
-
Dans la section OAuth 2, sous Generated access token, cliquez sur Generate.
-
Prenez en note le jeton d'accès (Access token) de votre application. Vous avez besoin de cette valeur lorsque vous configurez votre fournisseur de sécurité et votre source Dropbox for Business (voir Configuration d’un fournisseur de sécurité Dropbox for Business et Configuration et indexation d'une source Dropbox for Business).
Note : Vous pouvez maintenant créer un fournisseur de sécurité Dropbox for Business (voir Configuration d’un fournisseur de sécurité Dropbox for Business).
-
-
Lorsque vous souhaitez utiliser OAuth 1.0, notez les valeurs App key et App Secret de votre application. Vous avez besoin de cette valeur lorsque vous configurez votre fournisseur de sécurité et votre source Dropbox for Business (voir Configuration d’un fournisseur de sécurité Dropbox for Business et Configuration et indexation d'une source Dropbox for Business).
Note : Avec ces deux informations en main, vous pouvez faire des appels API afin d’obtenir un secret de jeton OAuth et un jeton OAuth (voir l'étape 2).
-
-
-
Make an API call for a request token and a token secret:
Important : Pour des raisons de sécurité, vous avez peu de temps pour compléter cette étape avant l’expiration de la session. Si ceci se produit, vous devez recommencer la procédure. Il est donc recommandé de lire et de comprendre la procédure avant de la commencer.
-
Accédez à la page d'extension Advanced REST client de Google Chrome, puis cliquez sur le bouton + Free.
Note : On vous demande de télécharger Google Chrome si le navigateur n’est pas déjà installé sur votre ordinateur.
-
Dans la boîte de dialogue Confirm New App, cliquez sur Add.
-
Dans la page Apps, ouvrez le plug-in Advanced REST client.
-
Dans la page Request :
-
Dans la boîte URL, entrez https://api.dropbox.com/1/oauth/request_token.
-
Dans la liste de méthodes, cochez POST.
-
À coté de Headers, sélectionnez Raw.
-
Dans la boîte sous Headers, copiez et collez le code suivant après avoir saisi votre Key app et votre App secret précédemment obtenus à l’étape 1d aux endroits spécifiés : Authorization: OAuth oauth_version="1.0", oauth_signature_method="PLAINTEXT", oauth_consumer_key="YOURAPPKEY", oauth_signature="YOURAPPSECRET&".
Note : Laissez le signe & à la fin de votre App secret.
-
Cliquez sur Send pour recevoir une réponse.
Au bas de la page, dans la boîte Response, la réponse que vous recevez ressemble à ceci : oauth_token_secret=YOUROAUTHTOKENSECRETVALUE&oauth_token=YOUROAUTHTOKENVALUE.
Note : Le signe & ne fait pas partie du secret de jeton OAuth.
-
-
Prenez en note les valeurs du secret de jeton OAuth et du jeton OAuth.
-
-
Autorisez votre application à utiliser le compte Dropbox :
-
Copiez et collez l’URL suivant dans la barre d’adresse de votre navigateur après avoir entré votre jeton OAuth dans le lieu spécifié : https://www.dropbox.com/1/oauth/authorize?oauth_token=YOUROAUTHTOKENVALUE.
Note : Si vous obtenez une erreur comme celle-ci : This session has expired. Please return to the app to try again., connectez-vous à nouveau dans votre compte d’administrateur Dropbox for Business.
-
Dans l'écran [Your app name] would like to access [Team name]'s team information and activity log, as well as the ability to perform any action as any team member, cliquez sur Allow pour permettre au connecteur d'indexer le contenu Dropbox des membres de votre équipe.
-
-
Faites un appel API pour un jeton d’accès et un secret de jeton d’accès :
Important : Pour des raisons de sécurité, vous avez peu de temps pour compléter cette étape avant l’expiration de la session. Si ceci se produit, vous devez recommencer la procédure. Il est donc recommandé de lire et de comprendre la procédure avant de la commencer.
-
De retour à la page Request :
-
Dans la boîte URL, entrez https://api.dropbox.com/1/oauth/access_token.
-
Dans la liste de méthodes, cochez POST.
-
À côté de Headers, sélectionnez Raw.
-
Dans la boîte sous Headers, copiez et collez le code suivant après avoir entré votre App key, jeton OAuth, App secret et secret de jeton OAuth obtenus précédemment aux lieus spécifiés : Authorization: OAuth oauth_version="1.0", oauth_signature_method="PLAINTEXT", oauth_consumer_key="YOURAPPKEYVALUE", oauth_token="YOUROAUTHTOKENVALUE", oauth_signature="YOURAPPSECRETVALUE&YOUROAUTHTOKENSECRETVALUE".
Note : Laissez le signe & entre le App secret et la valeur du secret de jeton OAuth.
-
Cliquez sur Send pour recevoir une réponse.
Au bas de la page, dans la boîte Response, la réponse que vous recevez ressemble à ceci : oauth_token_secret=YOUROAUTHTOKENSECRETVALUE&team_id=YOURTEAMIDVALUE&oauth_token=YOUROAUTHTOKENVALUE&uid=99026670.
Notes :
-
Le signe & ne fait pas partie de la valeur du secret de jeton OAuth.
-
Le signe & et les caractères alphanumériques suivants ne font pas partie de la valeur du jeton OAuth.
-
-
Prenez en note les valeurs du secret de jeton OAuth et du jeton OAuth. Vous avez besoin de cette valeur lorsque vous configurez votre fournisseur de sécurité et votre source Dropbox for Business (voir Configuration d’un fournisseur de sécurité Dropbox for Business et Configuration et indexation d'une source Dropbox for Business).
-
-
Prochaines étapes?
Créez un fournisseur de sécurité Dropbox for Business (Configuration d’un fournisseur de sécurité Dropbox for Business).