DropBox et 'refresh token'

Bonjour,

après avoir parcouru des dizaines et dizaines de pages internet 8O, voici la solution que j'ai mis en place chez moi:
Ceux qui sont confrontés à ce problème, connaissent certainement déjà la procédure qui consiste à lier l'application développée, au système DropBox:

Étape N°1: déclarer son application auprès du système DropBox "DBX Platform" située ici.
Ce portail vous permet d'obtenir la clé et code secret (KeyApp et Secret), attribuées à votre application par la plateforme DBX.
Ces éléments doivent être intégrés à votre logiciel, afin que celui-ci puisse obtenir, le moment voulu, un jeton d'accès via l'API DropBox.

Étape N°2: votre logiciel doit permettre à l'utilisateur de lier sa DropBox, à l'application développée par vous.
Pour cela, le programme doit proposer la procédure suivante:

Amener l'utilisateur vers la page Internet, de liaison 'Application/DropBox'
L'utilisateur obtient un code unique fournit par cette page; qu'il devra renseigner dans votre logiciel (via un copier-coller dans un champ de saisie probablement)
Finaliser l'enregistrement de l'application, afin que votre programme obtienne le(s) jeton(s) d'accès, appelé TOKEN(s)

Nota: j'ai mis TOKEN(s) car auparavant, nous obtenions un TOKEN valable indéfiniment auprès de la plateforme DBX. Or maintenant, le TOKEN délivré n'est valable que 4 heures. Il faut donc, à chaque utilisation de votre logiciel, que ce dernier récupère un nouveau TOKEN... or on ne peut pas demander à l'utilisateur de votre programme, de re-passer à chaque fois par cette procédure :roll:... j'expliquerai plus loin, comment votre programme fera pour obtenir automatiquement, un nouveau TOKEN, sans re-passer par cette 1ère phase.

En attendant, voici quelques lignes de code permettant d'aller jusqu'à l'obtention du 1er TOKEN initial.
Bien entendu, vous avez déjà en votre possession la clé et code secret (KeyApp et Secret ), obtenus via la plateforme DBX.
Code:

1 2 3 4 5 DbxAppInfo dbxAppInfo = new DbxAppInfo( "votreCleApplication", "votreCodeSecretApplication" ); DbxRequestConfig dbxRequestConfig = new DbxRequestConfig( "nomDeVotreApplication" )); // C'est le nom que vous avez déclaré à la plateforme DBX lors de l'étape N°1 DbxWebAuth dbxWebAuth = new DbxWebAuth( dbxRequestConfig, dbxAppInfo ); Request webAuthRequest = DbxWebAuth.newRequestBuilder().withNoRedirect().withTokenAccessType( TokenAccessType.OFFLINE ).build(); String sUrlAuthorisation = dbxWebAuth.authorize( webAuthRequest );
Notez que dans la ligne 4, on prépare la demande d'un TOKEN de type "TokenAccessType.OFFLINE"
En finalité, sUrlAuthorisation contiendra une adresse HTTP amenant l'utilisateur vers le portail de demande du TOKEN initial.

Il suffira dès lors de faire ouvrir un navigateur internet par votre programme, pour que l'utilisateur se retrouve sur le portail de liaison 'Application/DropBox', et obtienne le code de finalisation. Par exemple:
Code:

1 2 3 4 5 6 7 8 try { Desktop.getDesktop().browse( new URI( "sUrlAuthorisation" ))); } catch( IOException | URISyntaxException e ) { JOptionPane.showMessageDialog( null, "Impossible d'ouvrir votre navigateur Internet, avec l'adresse spécifiée.", "ACTION IMPOSSIBLE", JOptionPane.WARNING_MESSAGE ); }
Il faut maintenant, demander à l'utilisateur, de fournir à votre programme, le fameux code de finalisation (Par un copier-coller par exemple).
Une fois cet élément renseigné, votre programme devra engager la procédure suivante pour obtenir le TOKEN initial:
Code:

1 2 3 4 5 6 7 8 9 10 11 12 13 DbxAppInfo dbxAppInfo = new DbxAppInfo( "votreCleApplication", "votreCodeSecretApplication" ); DbxRequestConfig dbxRequestConfig = new DbxRequestConfig( "nomDeVotreApplication" )); DbxWebAuth dbxWebAuth = new DbxWebAuth( dbxRequestConfig, dbxAppInfo ); try { dbxAuthFinish = dbxWebAuth.finishFromCode( txtCodeDBX.getText().trim()); // txtCodeDBX est un JTextField contenant le "code" inscrit par l'utilisateur } catch( DbxException dbxE ) { JOptionPane.showMessageDialog( null, "GROS PROBLEME", "Echec d'authentification DropBox.", JOptionPane.ERROR_MESSAGE ); return; }
dbxAuthFinish contient des informations intéressantes:

dbxAuthFinish.getAccountId(), le N° de compte attribué à cet utilisateur
dbxAuthFinish.getUserId(), l'identifiant attribué à cet utilisateur

... et contient des informations essentielles:

String sDbxTokenRegistre = dbxAuthFinish.getAccessToken(), le TOKEN initial, qui ne sera valable que 4 heures
String sDbxRefreshTokenRegistre= dbxAuthFinish.getRefreshToken(), le 'REFRESH_TOKEN', qui vous permettra d'obtenir à chaque nouvelle session, un nouveau TOKEN

Ces 2 éléments devront être mémorisés par votre programme, pour pouvoir ensuite, accéder à la DropBox liée.

Comment établir maintenant, une connexion de téléchargement ou téléversement avec la DropBox liée...
Code:

1 2 3 4 5 6 7 8 9 DbxCredential confirmeIdentite = new DbxCredential( sDbxTokenRegistre, // Le TOKEN initial (qui n'était valable que 4 heures) -1L, // Durée désirée de connexion, dans ce cas, illimitée sDbxRefreshTokenRegistre, // Le fameux 'REFRESH_TOKEN' "votreCleApplication", "votreCodeSecretApplication" ); DbxRequestConfig dbxRequestConfig = new DbxRequestConfig( "nomDeVotreApplication" ); DbxClientV2dbxClient dbxClient = new DbxClientV2( dbxRequestConfig, confirmeIdentite );
Voilà, l'objet dbxClient vous donne accès à toutes les fonctionnalité de l'API DropBox.
J'espère que ce post (qui finalement ressemble à un tuto) est suffisamment clair pour éviter aux intéressés, de perdre des heures de recherche sur Internet :calim2:.

Remarque importante: les lignes de code exemple sont établies pour l'API V7 de DropBox. Veillez à avoir la bonne bibliothèque API.