Réinitialiser le code secret du client pour un compte de service

Tous les comptes de service traditionnels ont pris fin le 18 mars 2025.

Les comptes de service traditionnels ont été abandonnés le 9 décembre 2021. À compter du 21 janvier 2025, nous n’autoriserons plus la création de nouveaux comptes de service traditionnels. Les comptes de service traditionnels existants continueront de fonctionner jusqu’au 18 mars 2025.

Conformément à ce calendrier, les développeurs d’applications de connexion de données qui utilisent actuellement des comptes de service traditionnels sont tenus de mettre à jour leurs applications pour utiliser des comptes de service gérés par les développeurs, et les clients devront installer ces applications mises à jour avant la date d’extinction. Toutes les applications de connexion de données qui n’ont pas été migrées à la date d’expiration cesseront de fonctionner. Toute application répertoriée sur Procore App Marketplace qui n’utilise pas une méthode prise en charge pour accéder à l’Procore API sera supprimée à la date d’expiration. Pour plus d’informations, reportez-vous à la section Migration des applications de connexion de données vers l’utilisation des DMSA.

Les comptes de services vous permettent de prendre en charge les intégrations qui nécessitent le flux d’octroi de Identifiants client tel que défini dans le IETF OAuth 2.0 Framework Specification. Dans ce scénario, les applications ont besoin d’un moyen de récupérer un jeton d’accès OAuth 2.0 en dehors du contexte d’un utilisateur Procore spécifique. OAuth 2.0 fournit le type d’autorisation d’Identifiants du client à cet effet. Un client_idet un client_secretuniques sont générés lorsqu’un nouveau compte de service est créé. Pour plus d’informations sur la mise en œuvre du flux d’octroi de Identifiants client dans un application, consultez Utilisation du OAuth 2.0 Identifiants client sur notre portail des développeurs.

• Autorisation utilisateur requise :

  • Autorisations de niveau « Admin » dans l’outil Admin de l’entreprise.

• Nouveaux éléments d’accès au service :

  • client_id. Le identifiant du compte de service.

  • client_secret. Le secret est un code généré aléatoirement qui sera utilisé par le compte de service. Il n’est visible que par vous au moment de la création du compte. Notez le client_secret, puis enregistrez-le dans un lieu sécurisé si vous en avez besoin à l’avenir pour référence.
    À noter : Si, pour une raison quelconque, vous perdez le client_secret, Procore recommande de créer un nouveau compte de service.

  • Par défaut, les nouveaux comptes de service sont créés sans autorisations (« Aucun(e) ». Pour modifier ces autorisations, voir Configurer les autorisations des comptes de service.

• Considérations importantes concernant l’annuaire de l’entreprise :

  • Une fois que vous avez créé un compte de service, l’adresse e-mail associée ne doit pas être modifiée dans l’annuaire de l’entreprise. Si vous modifiez l’adresse e-mail du compte de service, le compte de service ne sera plus fonctionnel.

  • Le contact du compte de service ne peut pas être ajouté à plus d’un annuaire de l’entreprise (uniquement celui dans lequel il a été créé), sinon il cessera de fonctionner.

1. Accédez à l’outil Admin au niveau entreprise.

2. Sous « Paramètres de l’entreprise », cliquez sur Comptes de service.

3. Recherchez le compte de service pour lequel vous souhaitez réinitialiser le code secret du client et cliquez sur Afficher.

4. Cliquez sur Réinitialiser le code secret pour réinitialiser le code secret du client pour le compte de service sélectionné.
   

5. Cliquez sur Continuer pour confirmer votre action.