Inhalt: 
Dieser Dokumentationsartikel erklärt, wie Du deine Authentifizierung für OTTO Market auf die aktuellen Anforderungen umstellen kannst.

THEMENVERZEICHNIS



Lesezeit: ca. 10 - 15 Minuten

Einleitung


Der Marktplatz OTTO Market hat seine Authentifizierung verändert.
Bislang hast Du die Verbindung zur OTTO API über einen api_xxxxx-User mit entsprechendem Passwort aufgebaut. Nun benötigst Du zukünftig einen Token. 



WICHTIG:
Die bisherige Authentifizierungsmethode über einen API-User wird nur noch bis Ende September 2024 unterstützt. Bis dahin musst Du auf die neue, tokenbasierte Authentifizierungsmethode umgestellt haben, da ansonsten keinerlei Abgleiche mehr erfolgen können. Die OTTO Market API lehnt ab Oktober 2024 alle API Aufrufe mit der bisherigen Methode ausnahmslos ab.





Im Folgenden kannst Du nachlesen, wie du die Umstellung vornehmen kannst, damit Du weiterhin Deine Produkte updaten und Deine Bestellungen, sowie Versandbestätigungen transferieren kannst.



Wichtiger Hinweis:
Solltest Du hier Unterstützung benötigen stehen unsere Support-Mitarbeiter gerne zur Verfügung und übernehmen das für Dich.



Video zur Umstellung auf OAuth2 in unicorn 2


Sieh Dir das Video an, um zu sehen, wie die Umstellung in den Masken und im Browser aussieht.

Die Schritt-für-Schritt-Anleitung mit Screenshots findest du weiter unten.


Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Video zeigt die Umstellung der Authentifizierungsmöglichkeit in unicorn 2.)



Umstellung auf OAuth2 in unicorn 2 - step-by-step


1. Öffne unicorn 2 und navigiere zum OTTO Market-Shop. Oben links siehst du den Button "Marktplatz Zugang". Klicke darauf, um zu der Authentifizierungsposition zu gelangen. 
Nun siehst Du Deine bisherige Authentifizierung via API-User und Passwort.

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt die Marktplatz Zugangsdaten-Konfiguration in unicorn 2.)



2. Klicke auf den Haken "OAuth2 Authentifizierung benutzen". Danach erscheint ein langgezogener Button "Token erzeugen". 

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt die Marktplatz Zugangsdaten-Konfiguration in  unicorn 2.)



3. Klicke den Button "Token erzeugen", um den Prozess einzuleiten. 

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt die Marktplatz Zugangsdaten-Konfiguration in unicorn 2.)



4. Es öffnet sich ein neues Fenster "OTTOMarket Token" in der Konfigurationsoberfläche.

Klicke auf den Button "Token generieren".

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt die Token-Konfiguration in unicorn 2.)



5. Es zeigt sich ein Hinweis darauf, dass sich Dein Browserfenster öffnen wird und Du auf die OTTO Partner Connect (OPC) Seite weitergeleitet wirst. 

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt ein Infofenster in unicorn 2.)



6. Nun öffnet sich das OPC, logge Dich mit deinen gewohnten Login-Daten (E-Mail und Passwort) ein.Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt die Login-Seite von OTTO Market.)



7. Du wirst weitergeleitet auf die Seite des OPC, auf der Du unicorn 2 befähigen sollst, dass die Software die entsprechenden Berechtigungen erhält, um die Daten auch in Deinem Namen austauschen zu dürfen. Beachte, dass hier das Prinzip alles-oder-nichts gilt.

Wenn Du damit einverstanden bist, bestätigst Du über den Button "Bestätigen".

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt ein Infofenster in OTTO Market.)



8. Ein weiteres Fenster öffnet sich nun im OPC, indem Du Deine Identität bestätigen sollst. 

Klicke auf "Bestätigen".

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt ein  Infofenster in OTTO Market.)



9. Nun wird Dir orange hinterlegt ein großes Textfeld angezeigt, indem ein zufälliges Zusammenspiel von Zahlen und Buchstaben erscheint. Dies ist Dein Token. 

Klicke auf den Button "copy", um diesen zu kopieren. 


Bitte beachte: wir empfehlen NICHT manuell den Token zu kopieren, es besteht die Möglichkeit, dass Du nicht alle Zeichen erwischst und dann kann der Token im weiteren Schritt nicht validiert werden.

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt ein Infofenster im OPC.)



10. Füge den Token, der sich in Deiner Zwischenablage befindet, in unicorn 2 in das Feld "Schritt 2:" (1) ein.

Klicke dann auf "Token validieren" (2).

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt ein Infofenster in unicorn 2.)



11. Es öffnet sich ein Informationsfenster, worin bestätigt wird, dass Dein Token erfolgreich geprüft und abgespeichert werden konnte. 

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt ein Infofenster in unicorn 2 .)



12. Speichere zum Schluss Deine Konfiguration ab:

Das Bild zeigt die sonstigen Einstellungen in unicorn 2.(Im Sinne der Barrierefreiheit: Das Bild zeigt ein Konfigurationsfenster für Marktplatzanbindungen in unicorn 2.)



Herzlichen Glückwunsch, Deine Umstellung auf die neue Authentifizierungsweise von OTTO Market ist erfolgreich umgesetzt.