Zu Content springen
Deutsch
Kontakt
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

ACC über einen Secure Service Account mit big verbinden

Autodesk-App und Service Account einrichten, Schlüssel vorbereiten und Projektzugriff vergeben

Für die ACC-Anbindung können Sie einen Autodesk Secure Service Account (SSA) verwenden. Die Einrichtung umfasst eine Autodesk-App, den Service Account mit Schlüsselpaar, den Zugriff auf die benötigten ACC-Projekte und die Konfiguration in big.

Autodesk-App registrieren

  1. Öffnen Sie Autodesk Platform Services und wählen Sie im Profilmenü My applications. Wählen Sie anschließend den Developer Hub.
  2. Erstellen Sie eine neue App mit einem beschreibenden Namen, beispielsweise big-ACC-Integration.
  3. Wählen Sie als Application Type die Option Server-to-Server App und legen Sie den benötigten API Access fest.
App-Zugangsdaten sichern

Unter App settings finden Sie die Client ID und das Client Secret. Bewahren Sie das Client Secret geschützt auf. Es darf nicht in öffentlichen Repositories, clientseitigem Code oder E-Mails abgelegt werden.

Für die nächsten Schritte können Sie den SSA Manager von Autodesk verwenden. Nach Log In mit den Zugangsdaten der App stehen die Bereiche Accounts, Keys und Access Token zur Verfügung.

Service Account und Schlüssel erstellen
  1. Öffnen Sie im SSA Manager Accounts.
  2. Tragen Sie unter Create Account With Name einen beschreibenden Namen ein, beispielsweise service-big-accsync, und wählen Sie Create.
  3. Halten Sie die serviceAccountId und die automatisch erzeugte E-Mail-Adresse des Service Accounts fest.
  4. Öffnen Sie Keys, wählen Sie den gerade erstellten Account aus und wählen Sie Create Key.

Wichtig: Der Private Key kann nach der Erstellung nicht erneut abgerufen werden. Speichern Sie die .pem-Datei sofort an einem geschützten Ort, beispielsweise in einem Secrets Manager oder verschlüsselten Tresor.

Private Key lokal in PKCS#8 umwandeln

Wenn die ACC-Anbindung in big einen Private Key im Format PKCS#8 benötigt und Ihr Schlüssel im Format PKCS#1 vorliegt, führen Sie die Umwandlung lokal mit OpenSSL aus:

openssl pkcs8 -topk8 -nocrypt -in ssa-private-key.pem -out ssa-private-key-pkcs8.pem

Die Ausgabedatei enthält einen unverschlüsselten Private Key. Bewahren Sie auch diese Datei geschützt auf und verwenden Sie ihren Inhalt nur für die vorgesehene Konfiguration. Geben Sie den Private Key nicht in ein öffentliches Online-Konvertierungswerkzeug ein.

Service Account zu ACC hinzufügen
  1. Öffnen Sie Autodesk Construction Cloud und die Account Admin- oder Project Admin-Konsole.
  2. Fügen Sie auf der Mitglieder-Seite die in Accounts angezeigte E-Mail-Adresse des Service Accounts als Mitglied hinzu.
  3. Weisen Sie ihm die für die Anbindung benötigten Projekt-, Produkt- und Ordnerrechte zu.

Der Service Account benötigt Zugriff auf die betreffenden ACC-Projekte. Fehlt die Projektzuweisung, können API-Aufrufe für diese Projekte nicht erfolgreich ausgeführt werden.

Verbindung in big konfigurieren

Öffnen Sie die ACC-Anbindung in der Projektkonfiguration von big und hinterlegen Sie dort die für den Secure Service Account vorgesehenen Angaben und den vorbereiteten Private Key.