Migration von Datenverbindungsanwendungen zur Verwendung von entwicklerverwalteten Servicekonten

 Auslaufen traditioneller Servicekonten

Alle traditionellen Servicekonten werden am 31. Dezember 2024auslaufen.

Traditionelle Servicekonten wurden am 9. Dezember 2021 eingestellt. Ab dem 1. Oktober 2024 werden wir die Erstellung neuer Konten für traditionelle Dienstleistungen nicht mehr zulassen. Bestehende traditionelle Servicekonten sind bis zum 31. Dezember 2024 weiterhin funktionsfähig.

In Übereinstimmung mit diesem Zeitplan müssen Entwickler von Datenverbindungsanwendungen, die derzeit herkömmliche Dienstkonten verwenden, ihre Anwendungen aktualisieren,um Dateiname="">Entwicklerverwaltete Dienstkonten zu verwenden<a target="_blank" title=" " href.path="//faq/what-is-developer-managed-service-account" href., und die Kunden müssen diese aktualisierten Anwendungen vor dem Ablaufdatum installieren. Alle Datenverbindungsanwendungen, die bis zum Ablaufdatum nicht migriert wurden, funktionieren nicht mehr. Alle auf dem Procore-App Marketplace aufgeführten Anwendungen, die keine unterstützte Methode für den Zugriff auf die Procore API verwenden, werden bis zum Ablaufdatum entfernt. Siehe Migration von Datenverbindungsanwendungen zur Verwendung von DMSAs für zusätzliche Informationen.

Ziel

So migrieren Sie eine vorhandene Datenverbindungsanwendung, die ein herkömmliches Servicekonto verwendet, zu einer neuen Version, die ein verwaltetes Servicekonto für Entwickler verwendet.

Hintergrund

Mit der Abschaffung herkömmlicher Servicekonten und der Veröffentlichung von Entwicklerverwalteten Servicekonten (DMSA) müssen Kunden, die derzeit Datenverbindungsanwendungen verwenden, die auf herkömmlichen Servicekonten basieren, den Umstieg auf Anwendungen planen, die DMSAs verwenden, und zwar vor dem Ablaufdatum. Entwickler und Integratoren von Drittanbietern aktualisieren ihre Anwendungen für die Verwendung von DMSAs und stellen den Procore-Kunden im Laufe der Zeit neue Versionen zur Verfügung. Dieses Tutorial enthält einige Vorschläge für die Erstellung eines Migrationsplans und beschreibt die Verfahren für die Durchführung einer Migration.

Über das Procore Developer Portal

Das Procore Developer Portal ist eine umfassende Ressource für Entwickler, um ihr Verständnis und ihre Nutzung der Procore-APIs und anderer Entwicklungstools zu verbessern. Das Portal bietet ausführliche Dokumentationen, Leitfäden und Ressourcen, um Entwickler zu ermutigen, Anwendungen zu entwickeln, die sich in die Plattform von Procore integrieren lassen. Es ermöglicht eine nahtlose Interaktion mit der Baumanagement-Software von Procore und ermöglicht es Entwicklern, maßgeschneiderte Lösungen zu erstellen, die die Funktionalitäten von Procore erweitern.

Registrieren, Registrieren und Erstellen einer Anwendung auf dem Portal

Procore-Kunden, die daran interessiert sind, ihre eigenen Anwendungen zu erstellen, die sich in die Procore-Plattform integrieren lassen, können die folgenden Schritte ausführen, um ihre Entwicklungsreise zu beginnen:

Weitere Informationen finden Sie unter Erstellen von Procore-Datenverbindungsanwendungen mit DMSA .

Wichtige Hinweise

Vorbereitung der Migration

Die Kenntnis Ihrer bestehenden herkömmlichen Servicekonten kann Ihnen helfen, eine erfolgreiche Anwendungsmigration zu planen. Vor der Migration zu einer DMSA-Anwendung müssen Sie die Einstellungen für jedes Ihrer bestehenden Servicekonten überprüfen, um sicherzustellen, dass die Informationen korrekt sind, und um alle Servicekonten zu aktualisieren, bei denen die Einstellungen möglicherweise fehlen oder falsch sind.

Servicekonten werden in zwei Anwendungstypen eingeteilt: Marketplace und Benutzerdefiniert.

Beachten Sie, dass einige Servicekonten in Ihrem Unternehmen möglicherweise keinen definierten Anwendungstyp haben. Sie müssen diese Servicekonten mit dem richtigen Anwendungstyp aktualisieren, bevor Sie zu DMSAs migrieren. Dies ist auch eine gute Gelegenheit, die vorhandenen Einstellungen für den Anwendungstyp zu überprüfen und sicherzustellen, dass Ihre Servicekonten richtig zugeordnet sind.

Schritt 1 – Anwendungstyp für undefinierte Servicekonten festlegen

Gehen Sie wie folgt vor, um Ihre bestehenden Servicekonten zu aktualisieren, wenn der Anwendungstyp nicht definiert ist.

  1. Navigieren Sie zum Administrations-Tool des Unternehmens.
  2. Klicken Sie unter „Unternehmenseinstellungen“ auf Servicekonten. Die Seite „Servicekonten“ zeigt eine Liste der in Ihrem Unternehmen vorhandenen Servicekonten.

existing-service accounts.png

Wenn Sie Ihre Servicekonten überprüfen, sehen Sie möglicherweise ein oder mehrere Konten ohne Wert in der Spalte App-Name, wie im ersten Konto im obigen Beispiel. Dies bedeutet, dass der Anwendungstyp für dieses Servicekonto nicht definiert ist. Sie müssen diese Konten aktualisieren, bevor Sie zu DMSA migrieren.

  1. Suchen Sie ein Servicekonto, bei dem der Wert in der Spalte „App-Name“ fehlt, und klicken Sie auf Bearbeiten.

service-account-app-type.png

  1. Wählen Sie für die Einstellung „App-Typ“ eine der folgenden Optionen:
  • Marketplace: Wählen Sie diese Einstellung, wenn das Servicekonto einer Anwendung auf dem Procore App Marketplace zugeordnet ist. Verwenden Sie das Dropdown-Menü, um die App auszuwählen. Vergewissern Sie sich, dass die von Ihnen ausgewählte App mit der App übereinstimmt, die Sie in Produktion haben.

edit-account-marketplace.png

  • Benutzerdefiniert: Wählen Sie diese Einstellung, wenn das Servicekonto von einer App verwendet wird, die Sie intern entwickelt haben, oder von einer App, die von einem Drittanbieter speziell für Ihr Unternehmen entwickelt wurde. Geben Sie eine Beschreibung für das Konto sowie den Namen und die E-Mail-Adresse des Entwicklers ein.

edit-account-custom.png

  1. Klicken Sie auf Aktualisieren.
  2. Wiederholen Sie die obigen Schritte 3–5 für alle bestehenden Servicekonten in Ihrem Unternehmen, bei denen der Wert in der Spalte „App-Name“ fehlt.

Schritt 2 – Überprüfen und Verifizieren bestehender Servicekonto-Zuordnungen

Nehmen Sie sich nun ein paar Minuten Zeit, um jedes Konto zu überprüfen und sicherzustellen, dass die Zuordnung des Anwendungstyps korrekt ist und alle erforderlichen Felder ausgefüllt sind.

Überprüfung kundenspezifischer Servicekonten

  • Vergewissern Sie sich, dass alle als „benutzerdefiniert“ gekennzeichneten Servicekonten tatsächlich von benutzerdefinierten Integrationen und nicht von Marketplace-Anwendungen verwendet werden. Wenn Sie ein benutzerdefiniertes Servicekonto finden, das in ein Marketplace-Konto geändert werden sollte, aktualisieren Sie die Einstellung für den App-Typ wie im vorherigen Abschnitt beschrieben.
  • Überprüfen Sie, ob alle Konten für benutzerdefinierte Services in Ihrem Unternehmen aktiv genutzt werden. Entfernen Sie alle inaktiven Konten.
  • Vergewissern Sie sich, dass bei allen benutzerdefinierten Servicekonten in Ihrem Unternehmen die Felder Beschreibung, Name des Unternehmens/Entwicklers und E-Mail des Unternehmens/Entwicklers korrekt ausgefüllt sind. (siehe oben)

Überprüfung der Marketplace-Servicekonten

  • Vergewissern Sie sich, dass alle als „Marketplace“ gekennzeichneten Servicekonten tatsächlich von Anwendungen aus dem Procore App Marketplace verwendet werden, die Sie derzeit in der Produktion laufen haben. Wenn Sie ein „Marketplace“-Servicekonto finden, das in „Benutzerdefiniert“ geändert werden sollte, aktualisieren Sie die Einstellung „App-Typ“ wie im vorherigen Abschnitt beschrieben.
  • Vergewissern Sie sich, dass für alle Marketplace-Servicekonten die richtige Marketplace App in der Dropdown-Liste ausgewählt ist. (siehe oben)

Anwendungen auf DMSA migrieren

Die Schritte für die Migration einer Anwendung von einem herkömmlichen Servicekonto zu DMSA variieren je nach Anwendungstyp.

Marketplace-Anwendungen

  • Wenden Sie sich an die Entwickler Ihrer bestehenden, auf Servicekonten basierenden Marketplace-Anwendungen, um zu erfahren, wann sie voraussichtlich DMSA-fähige Versionen für ihre Kunden zur Verfügung stellen werden. Suchen Sie den Eintrag der Anwendung auf marketplace.procore.com und verwenden Sie die E-Mail- oder Support-Informationen des Entwicklers, um mit ihm Kontakt aufzunehmen.
  • Formulieren Sie einen internen Kommunikationsplan auf der Grundlage der vom Entwickler angegebenen Veröffentlichungstermine, damit Ihre Endbenutzer über alle anstehenden Anwendungsmigrationen informiert sind. Geben Sie einen Zeitplan für die Umstellung aller Benutzer auf die neuen Anwendungen und für die Einstellung der alten Versionen an.
  • Sobald die DMSA-fähige Version der Anwendung verfügbar ist, befolgen Sie die Schritte unter Installieren einer Datenverbindungsanwendung vom Marketplace. Wenn Sie sich nicht sicher sind, wie Sie die neue DMSA-fähige Version einer bestimmten Anwendung installieren sollen, wenden Sie sich an den Entwickler, um weitere Informationen zu erhalten.
  • Nachdem Sie die neue Marketplace-Anwendung erfolgreich installiert haben, weisen Sie Ihre Endbenutzer an, die neue Anwendung anstelle der älteren Version zu verwenden.
  • Nachdem alle Benutzer erfolgreich auf die neue Anwendung umgestellt wurden, können Sie das alte Servicekonto entfernen, wie unter Löschen eines Servicekontos und Deinstallieren der alten Version der Anwendung beschrieben.

Kundenspezifische Anwendungen

  • Wenn eine benutzerdefinierte Anwendung intern von Ihrem Unternehmen entwickelt und gepflegt wurde, müssen Sie eine neue DMSA-fähige Version der Anwendung entwickeln, wie in der Ankündigung Servicekonto-Abschaffung beschrieben. Weitere Informationen finden Sie unter Entwicklerverwaltete Servicekonten . Wenden Sie sich an apisupport@procore.com, wenn Sie zusätzliche Beratung benötigen.
  • Wenn eine benutzerdefinierte Anwendung von einem Drittanbieter speziell für Ihr Unternehmen entwickelt wurde, wenden Sie sich an diesen, um zu erfahren, wann eine neue DMSA-fähige Version der Anwendung verfügbar sein wird, und stellen Sie sicher, dass er die Informationen zur benutzerdefinierten Anwendung in der Benutzeroberfläche des Servicekontos ausfüllt.
  • Sobald die DMSA-fähige Version der benutzerdefinierten Anwendung verfügbar ist, befolgen Sie die unter Installation einer benutzerdefinierten Anwendung beschriebenen Schritte. Wenn Sie sich nicht sicher sind, wie Sie die neue DMSA-fähige Version einer bestimmten Anwendung installieren sollen, wenden Sie sich an den Entwickler, um weitere Informationen zu erhalten.
  • Nachdem Sie die neue benutzerdefinierte Anwendung erfolgreich installiert haben, weisen Sie Ihre Endbenutzer an, die neue Anwendung anstelle der älteren Version zu verwenden.
  • Nachdem alle Benutzer erfolgreich auf die neue Anwendung umgestellt wurden, können Sie das alte Servicekonto entfernen, wie in Löschen eines Servicekontos und Deinstallieren der alten Version der Anwendung beschrieben.

Siehe auch