ⓘ À compter du 14 juillet 2023, Contentsquare supprime les keys API.
- les keys API seront prises en charge jusqu'au 30 avril 2024
- pour les applications qui utilisent encore des keys API à la date du 30 avril 2024, les options suivantes cesseront de fonctionner :
- Raw Data et Métriques d'API
- connecteur Looker Studio
- extension Qualtrics (lecteur de Session Replay intégré)
- Reeport
- Dexem
- Suivez les instructions ci-dessous pour créer des identifiants OAuth et remplacer vos keys API.
Pourquoi migrer ?
Sécurité : Le flux d'authentification OAuth est plus sécurisé que les keys API. En effet, ce dernier fait appel à des jetons d'accès de courte durée plutôt qu'à des keys qui n'expirent jamais. Supprimer les keys API réduit donc les possibilités d'attaques (avoir plusieurs alternatives d'authentification donnent aux menaces potentielles plus d'options et d'opportunités).
Support multi-cloud : L'architecture du multi-cloud de Contentsquare (déploiement Azure ou AWS multi-région) a des points de terminaison API spécifiques pour chaque cloud et est donc mieux supportés par l'accès via le flux de jetons OAuth. De plus, la migration vous permet d'exploiter une bibliothèque OAuth existante avec laquelle vous êtes peut-être déjà familier pour les requêtes d'API.
Migration
API
Référez-vous à la documentation suivante pour effectuer la migration :
Looker Studio connector
1. Créez des identifiants OAuth en suivant les instructions de ce document.
2. Ouvrez un rapport de Looker Studio en utilisant la source de données Contentsquare et cliquez sur "Ajouter les données" pour ouvrir le catalogue des sources de données.
- Trouvez la source de données Contentsquare et cliquez sur "Révoquer l'accès".
3. Cliquez sur "Retirer" dans le pop-up de confirmation pour continuer.
4. Si vous voyez un autre pop-up indiquant qu'il y a une erreur, cliquez sur "Retirer quand même".
5. Quittez le catalogue des sources de données et réouvrez votre rapport. Il est normal que les widgets utilisant Contentsquare soient hors service (ils seront de nouveau fonctionnels lorsque vous serez au bout des instructions).
6. Sur les widgets cassés, vous devriez voir l'erreur "Autorisation requise". Cliquez sur "Autoriser maintenant" sur n'importe lequel de ces widgets.
7. Une nouvelle fenêtre s'ouvrira et vous demandera d'entrer de nouveaux identifiants. Saisissez votre ID client OAuth et secret client séparés par un tiret du bas (<yourCLientId>_<yourClientSecret>) et cliquez sur "Soumettre".
8. Rafraîchissez la page du rapport pour utiliser vos widgets normalement.
Mise à jour des identifiants pour utiliser les identifiants OAuth dans les extensions Chrome
1. Assurez-vous bien que vous utilisez la version 1.7.0, ou plus, de l'extension. Votre navigateur devrait avoir mis la version de l'extension à jour automatiquement. Si ce n'est pas le cas, faîtes appel à votre équipe IT : celle-ci a peut-être désactivé la mise à jour automatique des extensions Chrome.
2. Ouvrez l'extension et cliquez sur "Nouveaux identifiants API" dans le coin inférieur droit.
3. Dans le champ des identifiants d'API, entrez votre ID client suivi d'un tiret du bas et de votre secret client (<yourCLientId>_<yourClientSecret>), choisissez un mot de passe et cliquez sur "Enregistrer".
Extension Qualtrics (lecteur de Session Replay intégré)
Les identifiants OAuth ne sont pas encore supportés, un protocole de migration sera bientôt disponible.
Reeport
Les identifiants OAuth ne sont pas encore supportés, un protocole de migration sera bientôt disponible.
Dexem
Les identifiants OAuth ne sont pas encore supportés, un protocole de migration sera bientôt disponible.