Vorraussetzungen

Anforderungen	OAuth2 Grant Flow	OAuth2 Credential Flow
Grant Type	`authorization_code` (Autorisierungscode-Flow)	`client_credentials` (Anwendungszugriff ohne Benutzer)
State	Hat keine Signifikanz, muss aber mitgegeben werden. Der Inhalt spielt keine Rolle.	Hat keine Signifikanz, muss aber mitgegeben werden. Der Inhalt spielt keine Rolle.
Access Token	Ja, wird nach dem Austausch des Autorisierungscodes angefordert	Ja, wird direkt nach der Anfrage nach den client_credentials angefordert
client_id	Ja, wird immer benötigt, um die Anwendung zu identifizieren	Ja, wird immer benötigt, um die Anwendung zu identifizieren
Token Gruppe	Ja, wird immer benötigt.	Ja, wird immer benötigt.
Nevis Rolle	Ja, wird immer benötigt.	Ja, wird immer benötigt.
code	Ja, wird immer benötigt. Das ist der Auth Code.	Ja, wird immer benötigt. Das ist der Auth Code.
Benutzerinteraktion	Ja, der Benutzer muss sich einloggen und der Anwendung Zugriff gewähren	Nein, keine Benutzerinteraktion nötig
Redirect URI	Ja, die URL, wohin der Benutzer nach der Anmeldung zurückgeschickt wird mit dem Accesscode in der URL.	Nein, wird nicht benötigt
Authorization Code	Ja, nach der Benutzeranmeldung bekommt die Anwendung einen Autorisierungscode	Nein, wird nicht verwendet, nur initial.
client_secret	Das Secret wird von uns erstellt. Wir geben Ihnen diesen weiter.	Sie müssen diesen selber über apps.hin.ch erzeugen.

Beispiel Code für ein Refresh Token Python

import requestsimport time def get_new_access_token(refresh_token): url = "https://oauth2.hin.ch/REST/v1/OAuth/GetAccessToken" payload = f’grant_type=refresh_token&refresh_token={refresh_token}&client_id=ch.IhreClientID&client_secret={client_secret}› headers = { ‹Content-Type›: ‹application/x-www-form-urlencoded›, ‹Cookie›: ‹ObSSOCookie=/e0Sgr3R5FiCiOt+crc934SUK8g1RfTpUpytOJJ3sIivmXUBB3voBCq9lOc5j7A3/tYG3aTaT8Q-‹ } response = requests.post(url, headers=headers, data=payload) print(response.text) if response.status_code == 200: token_data = response.json() new_access_token = token_data[‹access_token›] # Optional: Ein neues Refresh-Token zurückgeben, wenn es vorhanden ist new_refresh_token = token_data.get(‹refresh_token›, refresh_token) return new_access_token, new_refresh_token else: print(f"Fehler beim Abrufen des Tokens: {response.status_code} – {response.text}") return None, refresh_token # Beispiel-Schleife, die regelmäßig das Access Token erneuertdef main(): refresh_token = ‹rteqr4› # Dein initiales Refresh Token while True: # Hier würde der Code für … Weiterlesen Beispiel Code für ein Refresh Token Python

Ablauf Refresh Token

Nachdem der Benutzer sich erfolgreich bei der Anwendung angemeldet hat, erhält der Client ein Access Token und ein Refresh Token. Das Access Token hat eine begrenzte Gültigkeitsdauer, während das Refresh Token länger gültig bleibt. Wenn das Access Token abläuft, sendet der Client einen POST-Request an den Token-Endpunkt des Autorisierungsservers. In diesem Request übermittelt der Client das Refresh Token sowie die Client-ID und das Client-Secret. Der Server … Weiterlesen Ablauf Refresh Token

Flow Charts

Grant Flow Credential Flow Weiterlesen Flow Charts

Einleitung Access Token – Für CC & Grant Flow

Ein Access Token ist notwendig, um auf geschützte Daten oder Funktionen einer Anwendung zuzugreifen. Um dieses Token zu erhalten, muss zuerst der Auth Token über einen POST-Request an den Server gesendet werden. Der Auth Token dient dabei als Authentifizierung, dass der Nutzer oder die Anwendung berechtigt ist, ein Access Token zu erhalten. Nach dem Absenden des POST-Requests gibt der Server eine Antwort zurück, die das Access Token enthält. Mit diesem … Weiterlesen Einleitung Access Token – Für CC & Grant Flow

Der Bezug eines Access Tokens mittels Curl – Credential Flow

Der Bezug des Client_Secret für die Curl Anfrage Beim Bezug des Access Tokens muss definiert werden, für welche TokenGruppe das Token gültig sein soll und das Client_Secret muss auf apps.hin.ch geholt werden, im Gegensatz zum Grant Flow, welches HIN definieren muss. Der Auth Token wird wie bei Variante A über apps.hin.ch geholt. Der Reiter erscheint erst wenn Initial eine fehlerhafter Request gesendet wird, … Weiterlesen Der Bezug eines Access Tokens mittels Curl – Credential Flow

Vorraussetzungen

Services

Antworten auf häufige Fragen

Informationen und Links

Fernwartung

HIN Customer Care Center

HIN Mail Support (neu)

HIN Mail Global Support (legacy)

Adresse