Mein Konto – Entwickler

1. Klicken Sie auf der Entwicklerseite auf den Link OAuth-Anwendungen, um eine Liste all Ihrer Apps zu sehen:

   

2. Klicken Sie auf die Schaltfläche Neue OAuth-Anwendung erstellen.

3. Füllen Sie das Formular aus:

   • Name: Name der Anwendung, die Benutzern angezeigt wird

   • Primäres Format: Zeichenfolge, die Ihre Anwendung eindeutig identifiziert und an der sich die Daten erkennen lassen, die die App möglicherweise auf Onshape-Servern speichert (z. B. com.beispiel.beispiel). Wurde die App registriert, kann dies nicht mehr geändert werden. Wird Benutzern nicht angezeigt.

   • Zusammenfassung: Beschreibung der angezeigten Anwendung für Benutzer, wenn sie gebeten werden, der Anwendung den Zugriff auf die eigenen Daten zu erlauben.

   • Weiterleitungs-URLs: URL, zu der Sie nach der Authentifizierung weitergeleitet werden (die Landing-Page Ihrer Anwendung).

     • Ihre Anwendung muss mindestens eine URL angeben, die beim OAuth-Protokollaustausch verwendet wird.

     • Diese URL muss auch SSL verwenden (eine URL, die mit https beginnt). Es gibt allerdings zwei Ausnahmen für installierte Desktop-Anwendungen: http://localhost: <port>und urn:ietf:wg:oauth:2.0:oob.

   • Typ: Anwendungstyp, Optionen: Integrierte Cloud-App, Verbundene Cloud-App oder Verbundene Desktop-App.

   • OAuth-URL: die URL, die verwendet wird, um den OAuth2-Prozess zur Benutzerauthentifizierung zu starten. Weitere Informationen finden Sie in der Entwicklerdokumentation unter „OAuth2“.

     • Sollte die URL Ihrer bereitgestellten Anwendung enthalten.

     • Dies ist die erste URL, die von der Onshape-Anwendungsseite aufgerufen wird.

     • Die Seite, die unter dieser URL gehostet wird, sollte die OAuth-Authentifizierung verarbeiten. Sobald der Server Ihrer Anwendung im Auftrag des Benutzers authentifiziert wurde, sollte dieser Benutzer zu Ihrer Anwendung umgeleitet werden.

     • Wenn Sie Ihre App noch nicht bereitgestellt haben, können Sie dieses Feld für die Arbeit an einem lokalen Rechner leer lassen und es später aktualisieren.

       Alle Anwendungen, die im Onshape App Store zur öffentlichen Verwendung eingereicht werden, müssen korrekt mit OAuth2 authentifiziert werden. Weitere Informationen finden Sie in der Entwicklerdokumentation unter „OAuth2“.

   • Einstellungen

     • Unterstützt Zusammenarbeit: aktivieren, wenn Sie bei der Entwicklung der Anwendung mit anderen Benutzern zusammenarbeiten möchten

   • Berechtigungen: siehe Berechtigungsbereiche unten

4. Klicken Sie auf Anwendung erstellen.

5. Kopieren Sie den geheimen OAuth-Schlüssel aus dem Fenster.

   Sie werden nicht wieder auf diesen geheimen Schlüssel zugreifen können. Dieses Geheimnis gilt nur für Sie und Ihre App. Es sollte wie jedes vertrauliche Passwort geschützt und niemals in den Quellcode integriert werden.

6. Der OAuth-Anwendungseintrag der App wird angezeigt, während die Registerkarte Details aktiv ist. Wenn Sie den Namen der App auf der Registerkarte OAuth-Anwendung auswählen, gelangen Sie jetzt zu diesem Bildschirm.

Mit den Registerkarten auf diesem Bildschirm haben Sie folgende Möglichkeiten:

• Details:

  • Store-Eintrag für die App erstellen

  • Eigentümerschaft an der App übertragen

  • Anwendung löschen

• Einstellungen: App-Einstellungen verwalten

• Schlüssel und Geheimnis:
  • OAuth-Client-Identifikationsschlüssel kopieren
  • Neuen geheimen OAuth-Client-Schlüssel erzeugen

• Berechtigungen: Berechtigungsbereiche der App ändern

• Erweiterungen: App-Erweiterungen verwalten

• Onshape OAuth: Onshape-Authentifizierung verwalten

• Externes OAuth: Drittanbieter-Authentifizierung verwalten

Weitere Informationen finden Sie in der Onshape-Dokumentation für Entwickler, einschließlich: korrekte Authentifizierung mit OAuth2 und Ausfüllen der Launch-Checkliste. Ein funktionierendes Beispiel finden Sie im Tutorial Hello World.

1. Klicken Sie auf der Entwickler-Seite in der Registerkarte auf OAuth-Anwendungen und wählen Sie dann Ihre Anwendung aus.

2. Klicken Sie auf die Registerkarte Erweiterungen.

   

3. Klicken Sie auf Erweiterung hinzufügen.

4. Füllen Sie das Formular aus:

   • Name: kann in der Benutzeroberfläche abgeschnitten werden, wenn er zu lang ist.

   • Beschreibung (optional): erscheint nicht in der Onshape-Benutzeroberfläche, könnte aber bei der Authentifizierung zu sehen sein.

   • Position: wo die Erweiterung in der Onshape-Benutzeroberfläche zu finden ist.

     • Weitere Informationen finden Sie in der Entwicklerdokumentation unter Unterstützte Positionen und Kontexte.

     • Sie können nur eine Element-Registerkartenerweiterung pro Anwendung erstellen.

   • Kontext: Manche Positionen funktionieren im Kontext einer Auswahl, zum Beispiel in einem Part Studio.

     • Weitere Informationen finden Sie in der Entwicklerdokumentation unter Unterstützte Positionen und Kontexte.

   • Aktions-URL: Bei Positionen, die eine Benutzeroberfläche einbetten, definiert die Aktions-URL die Adresse der anzuzeigenden Seite. Handelt es sich bei einer Position um eine Aktion (Kontextmenü, Symbolleistenelement, Aktion im Dialogfenster usw.) und der Aktionstyp ist GET oder POST, gibt die Aktions-URL den REST-Endpunkt an. Handelt es sich bei der Position um die Aktion „In neuem Fenster öffnen“, entspricht die Aktions-URL der URL, die in dem neuen Fenster geöffnet werden soll.

     • Eine Liste der Parameter, die in diesem Feld verwendet werden können, finden Sie in der Entwicklerdokumentation unter Aktions-URL-Parameter.

   • Aktionstyp: Gilt für Standorte, die keine Benutzeroberflächen einbetten. Unterstützte Aktionstypen sind:

     • GET: löst einen GET-API-Aufruf unter Verwendung der Aktions-URL aus. Die Parameterersetzung erfolgt bei der Aktions-URL.

     • POST: löst einen POST-API-Aufruf mit der Aktions-URL und dem Aktionstext als Beitragstext. Die Parameterersetzung erfolgt sowohl für bei der Aktions-URL als auch beim Aktionstext.

     • In neuem Fenster öffnen: öffnet die Aktions-URL in einem neuen Browserfenster. Die Parameterersetzung erfolgt bei der Aktions-URL.

   • Aktionstext: gilt nur für POST-Aktionstypen. Der Aktionstext wird in einem POST-API-Aufruf übergeben und muss ein gültiges JSON-Format haben.

   • Antwort anzeigen: gilt nur, wenn der Aktionstyp GET oder POST ist. Wenn ausgewählt, wartet die Benutzeroberfläche auf eine Antwort und zeigt diese dann in einem Dialogfenster in der Benutzeroberfläche an. Die Antwort muss ein gültiges JSON-Format haben.

   • Symbol: Das Symbol wird dort angezeigt, wo die Erweiterung vorhanden ist. Das umfasst auch Symbole, die zu einer Informationspalette, einer Kontextmenü-Aktion, einer Symbolleisten-Schaltfläche, einer Aktions-Schaltfläche in einem Dialogfenster oder zu anderen unterstützten Positionen gehören.

5. Klicken Sie auf OK.

Weitere Informationen zum Erstellen und Verwalten von Onshape-Anwendungen finden Sie in der Onshape-Dokumentation für Entwickler. Ein funktionierendes Beispiel finden Sie im Tutorial Hello World.

1. Klicken Sie in Ihren Entwicklereinstellungen auf OAuth-Anwendungen.
2. Klicken Sie auf den Namen der App, die übertragen werden soll.
3. Klicken Sie auf der Registerkarte Details auf die Schaltfläche Eigentümerschaft übertragen. Das Dialogfenster Übertragen wird geöffnet.

   

4. Wählen Sie eine Option aus, um die App an eine Einzelperson, eine Company oder ein Enterprise zu übertragen.
5. Um an eine Einzelperson zu übertragen, geben Sie den Namen oder die E-Mail-Adresse des neuen Eigentümers in das Suchfeld ein. Um die Eigentümerschaft an eine Company oder ein Enterprise zu übertragen, wählen Sie eine Option aus dem Dropdown-Menü aus.
6. Klicken Sie auf Eigentümerschaft übertragen. Die Anwendung wird darauf aus Ihrer OAuth-Apps-Liste entfernt.
   • Wenn die App an das Konto einer Einzelperson übertragen wurde, erhält dieser Benutzer eine E-Mail-Benachrichtigung und die App wird in seinem Onshape-Entwicklerportal angezeigt.
   • Wenn die App an ein Company-, Classroom- oder Enterprise-Mitglied übertragen wurde, erhalten alle Administratoren eine E-Mail-Benachrichtigung und die App wird in ihren Entwicklereinstellungen angezeigt.

Der zukünftige Verbrauch und die Abrechnung von API-Aufrufen werden dem neuen Eigentümer zugerechnet. Weitere Informationen finden Sie unter API-Grenzwerte.

1. Klicken Sie im linken Bereich Ihrer Company-Einstellungen auf Entwickler, klicken Sie dann auf OAuth-Anwendungen und wählen Sie anschließend die App aus, die Sie deaktivieren möchten.
2. Klicken Sie auf die Schaltfläche Status, um den aktuellen Status der Anwendung und alle unterstützten Statusänderungen anzuzeigen. Zu den unterstützten Status gehören:
   • Aktiv: Die Anwendung ist im Onshape App Store verfügbar.
   • Deaktiviert: Die App ist nicht mehr im App Store verfügbar, aber bestehende Benutzer können weiterhin darauf zugreifen.
   • In den Papierkorb verschoben: Die App wird von der Registerkarte OAuth-Anwendung entfernt und in die Registerkarte Papierkorb verschoben.

     • Das Verschieben in den Papierkorb ist erst erlaubt, wenn alle bezahlten Abonnements abgelaufen sind.

     • Alle Käufe und Zuschüsse werden bereinigt.

   • Gelöscht: Die Anwendung wird dauerhaft aus dem Papierkorb entfernt. Das kann nicht rückgängig gemacht werden.
     
3. Wählen Sie die gewünschte Statusänderung aus.
4. Geben Sie den Namen der App ein und klicken Sie erneut zur Bestätigung im Dialogfenster.

So erstellen Sie eine neue Store-Einreichung für eine OAuth-Anwendung:

1. Klicken Sie auf der Entwicklerseite auf OAuth-Anwendungen und wählen Sie dann Ihre Anwendung aus.

2. Klicken Sie in der Registerkarte Details der App auf Store-Eintrag erstellen.

   

3. Füllen Sie das Formular aus:

   • Name: wird automatisch anhand des bei der Registrierung angegebenen App-Namens festgelegt.

   • Zusammenfassung: wird automatisch anhand der bei der Registrierung bereitgestellten Zusammenfassung festgelegt.

   • Typ – Anwendungstyp: Integrierte Cloud-App, Verbundene Cloud-App oder Verbundene Desktop-App. Dies sollte dem Typ entsprechen, der bei der Registrierung der OAuth-Anwendung ausgewählt wurde.

   • Kategorie: Wählen Sie die entsprechende Kategorie für Ihre App aus.

   • Team-Sichtbarkeit: Geben Sie an, ob die private Einreichung beim App Store für keine internen Benutzer (Standard), alle internen Benutzer oder bestimmte Teams zu sehen sein soll.

   • Beschreibung: Beschreibung der Anwendung, die dem Benutzer angezeigt wird. Eine gewisse Formatierung ist möglich.

   • Support-URL: URL oder E-Mail-Adresse, an die Benutzer Ihrer App weitergeleitet werden sollten, um Hilfe zu erhalten. Diese URL oder E-Mail-Adresse muss aktiv überwacht werden.

   • Support-E-Mail: E-Mail-Adresse, an die Benachrichtigungen zum App-Abonnement gehen sollen. Diese E-Mail-Adresse muss aktiv überwacht werden.

   • Anbieter: Ihr Company-Name.

   • Version: aktuelle Version dieser Anwendung.

   • Bilder: Laden Sie optional Übersichts-, Hero- und andere Bilder hoch.

4. Klicken Sie auf Erstellen.

Die Anwendung wird im Onshape App Store als privat angezeigt. Sie ist nur für Sie und alle internen Teams sichtbar, die in den Team-Sichtbarkeitseinstellungen angegeben sind. Um die App öffentlich zu machen, sehen Sie sich als Nächstes die Launch-Checkliste an.

Um zu diesem Bildschirm zurückzukehren, klicken Sie auf die Registerkarte Store-Eintrag der Anwendung:

Einzelne Kontobenutzer können die App im Onshape App Store abonnieren:

1. Gehen Sie zum Onshape App Store: https://cad.onshape.com/appstore
2. Wählen Sie die App aus. Die App ist immer noch privat und kann nur von Ihnen als Ersteller gesehen werden:
   
3. Klicken Sie auf Abonnieren:
   
4. Folgen Sie den Anweisungen auf dem Bildschirm, um die App zu abonnieren.
5. Aktualisieren Sie Ihr Onshape-Browserfenster, um die App-Erweiterung zu testen.

1. Klicken Sie auf der Entwicklerseite auf OAuth-Anwendungen und wählen Sie dann Ihre Anwendung aus.
2. Klicken Sie auf den Store-Eintrag, um ihn zu löschen.
3. Klicken in der Registerkarte Details auf Store-Eintrag löschen
   
4. Klicken Sie zur Bestätigung erneut auf Löschen.