Skip to content

Commit c11c5f3

Browse files
silverhand-botfleuralycharIeszhao
authored
chore: update translations and generated content (#1282)
* chore: update translations and generated content * fix: irregular whitespaces --------- Co-authored-by: fleuraly <[email protected]> Co-authored-by: Charles Zhao <[email protected]>
1 parent 5d500d5 commit c11c5f3

File tree

55 files changed

+906
-665
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

55 files changed

+906
-665
lines changed

docs/end-user-flows/organization-experience/setup-app-service-with-management-api.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ The implementation is the same as the previous section. Always provide the organ
8080

8181
For details on protecting organization‑level API permissions, see the [full guide](/authorization/organization-level-api-resources).
8282

83-
### Using global RBAC
83+
### Using global RBAC \{#using-global-rbac}
8484

8585
In this case, you can use the Logto Management API to implement system-level access control.
8686

i18n/de/docusaurus-plugin-content-docs/current/end-user-flows/organization-experience/create-organization.mdx

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ sidebar_position: 3
44

55
# Organisation erstellen
66

7-
Stell dir vor, du entwickelst eine [Multi-Tenant-App](https://auth.wiki/multi-tenancy) (z. B. eine Multi-Tenant-SaaS-App), die viele Kunden bedient und jedem Kunden einen eigenen Mandanten zuweist.
7+
Stell dir vor, du baust eine [Multi-Tenant-App](https://auth.wiki/multi-tenancy) (z. B. eine Multi-Tenant-SaaS-App), die viele Kunden bedient, wobei jeder Kunde einen eigenen Tenant besitzt.
88

99
Organisationen werden typischerweise erstellt, wenn:
1010

11-
1. Neue Kunden sich registrieren und sowohl ein Konto als auch einen Mandanten für ihr Unternehmen anlegen.
11+
1. Neue Kunden sich registrieren und sowohl ein Konto als auch einen Tenant für ihr Unternehmen erstellen.
1212
2. Bestehende Benutzer innerhalb der App eine neue Organisation erstellen können.
1313

1414
<img src="/img/assets/new-account-creates-org.png" alt="Neues Konto erstellt Organisation" />
@@ -21,28 +21,31 @@ Organisationen werden typischerweise erstellt, wenn:
2121

2222
Es gibt zwei Möglichkeiten, Organisationen für deine App zu erstellen.
2323

24-
### Über die Logto Console erstellen \{#create-via-logto-console}
24+
### Erstellung über Logto Console \{#create-via-logto-console}
2525

2626
Erstelle Organisationen manuell in der Logto Console UI. Gehe zu <CloudLink to="/organizations">Console > Organizations</CloudLink>, um Organisationen zu erstellen, Mitglieder und Rollen zuzuweisen und die Anmeldeerfahrung der Organisation anzupassen.
2727

28-
Erstelle eine [Organisationstemplate](/authorization/organization-template), um ähnliche Organisationen, die die gleichen Rollen und Berechtigungen teilen, stapelweise zu erstellen.
28+
Erstelle eine [Organisation-Vorlage](/authorization/organization-template), um ähnliche Organisationen, die die gleichen Rollen und Berechtigungen teilen, im Batch zu erstellen.
2929

30-
### Über die Logto Management API erstellen \{#create-via-logto-management-api}
30+
### Erstellung über Logto Management API \{#create-via-logto-management-api}
3131

32-
Die Console eignet sich hervorragend für die manuelle Einrichtung, aber die meisten Apps ermöglichen es Endbenutzern, sich selbst zu bedienen – Organisationen direkt in deiner App zu erstellen und zu verwalten. Um dies zu ermöglichen, implementiere diese Funktionen mit der Logto Management API.
32+
Die Console ist großartig für die manuelle Einrichtung, aber die meisten Apps ermöglichen es Endbenutzern, sich selbst zu bedienen – Organisationen direkt in deiner App zu erstellen und zu verwalten. Um dies zu ermöglichen, implementiere diese Funktionen mit der Logto Management API.
3333

3434
:::note
3535

36-
Wenn du neu bei der Logto Management API bist, lies zuerst diese Seiten:
36+
Wenn du neu bei der Logto Management API bist oder die grundlegende Einführung zur Nutzung der Logto Management API für die Organisationserfahrung noch nicht gelesen hast, lies zuerst diese:
3737

38+
<Url href="/end-user-flows/organization-experience/setup-app-service-with-management-api">
39+
Richte deinen App-Service mit der Logto Management API ein
40+
</Url>
3841
<Url href="/concepts/core-service/#management-api">Management API</Url>
39-
<Url href="/integrate-logto/interact-with-management-api">Mit Management API interagieren</Url>
42+
<Url href="/integrate-logto/interact-with-management-api">Interaktion mit der Management API</Url>
4043

4144
:::
4245

43-
Angenommen, dein Backend ist über den Maschine-zu-Maschine (M2M) Mechanismus mit der Logto Management API verbunden und du hast ein M2M-Zugangstoken erhalten.
46+
Angenommen, dein Backend ist über den Maschine-zu-Maschine (M2M)-Mechanismus mit der Logto Management API verbunden und du hast ein M2M-Zugangstoken erhalten.
4447

45-
Erstelle eine Organisation mit der Management API ([API-Referenz](https://openapi.logto.io/operation/operation-createorganization)):
48+
Erstelle eine Organisation mit der Management API ([API-Referenzen](https://openapi.logto.io/operation/operation-createorganization)):
4649

4750
```bash
4851
curl \
@@ -70,6 +73,6 @@ Verpacke diese Aufrufe in deiner eigenen API-Schicht. Wenn Benutzer in deiner Ap
7073

7174
## Organisationstoken in Benutzeranfragen validieren \{#validating-organization-token-in-user-request}
7275

73-
In deiner App müssen Benutzer, wenn sie Aktionen im Kontext einer Organisation ausführen, ein Organisationstoken anstelle eines regulären Zugangstokens verwenden. Das Organisationstoken ist ein [JWT](https://auth.wiki/jwt), das Organisationsberechtigungen enthält. Wie bei jedem [Zugangstoken (Access token)](https://auth.wiki/access-token) kannst du die Ansprüche (Claims) dekodieren und den "scope"-Anspruch überprüfen, um Berechtigungen durchzusetzen.
76+
In deiner App müssen Benutzer, wenn sie Aktionen im Kontext einer Organisation ausführen, ein Organisationstoken anstelle eines regulären Zugangstokens verwenden. Das Organisationstoken ist ein [JWT](https://auth.wiki/jwt), das Organisationsberechtigungen enthält. Wie jedes [Zugangstoken (Access token)](https://auth.wiki/access-token) kannst du die Ansprüche (Claims) dekodieren und den "scope"-Anspruch überprüfen, um Berechtigungen durchzusetzen.
7477

7578
Siehe <Url href="/authorization">Autorisierung (Authorization)</Url> für weitere Informationen zu Autorisierungsszenarien und wie du Organisationstokens validierst.

i18n/de/docusaurus-plugin-content-docs/current/end-user-flows/organization-experience/get-user-info.mdx

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,15 @@ sidebar_position: 4
88

99
Dies wird üblicherweise auf der Benutzerprofilseite verwendet, auf der Benutzer ihre Organisationsinformationen anzeigen müssen.
1010

11-
<img src="/img/assets/user-info-page.png" alt="Organisation Benutzerinfo" />
11+
<img src="/img/assets/user-info-page.png" alt="Organisations-Benutzerinfo" />
1212

1313
## Wie wird es implementiert \{#how-to-implement-it}
1414

1515
Es gibt zwei Möglichkeiten, Benutzerinformationen innerhalb einer Organisation abzurufen.
1616

17-
### 1. Den ID-Token dekodieren \{#1-decode-the-id-token}
17+
### ID-Token entschlüsseln \{#decode-the-id-token}
1818

19-
Der ID-Token (ID token) ist ein standardisierter JWT, der Benutzerprofilinformationen und organisationsbezogene Ansprüche (Claims) enthält. Rufe die SDK-Methode `decodeIdToken()` auf, um ein JSON-Objekt wie dieses zu erhalten:
19+
Das ID-Token (ID token) ist ein standardisiertes JWT, das Benutzerprofilinformationen und organisationsbezogene Ansprüche (Claims) enthält. Rufe die SDK-Methode `decodeIdToken()` auf, um ein JSON-Objekt wie dieses zu erhalten:
2020

2121
```json
2222
{
@@ -42,8 +42,8 @@ Der ID-Token (ID token) ist ein standardisierter JWT, der Benutzerprofilinformat
4242
}
4343
```
4444

45-
Der ID-Token (ID token) wird jedoch nur während der Authentifizierung ausgestellt und kann veraltet sein, wenn sich das Benutzerprofil danach ändert.
46-
Für die aktuellsten Informationen verwende die zweite Methode unten oder rufe `clearAllTokens()` auf und starte einen Authentifizierungsfluss neu, um einen frischen ID-Token (ID token) zu erhalten.
45+
Das ID-Token (ID token) wird jedoch nur während der Authentifizierung ausgegeben und kann veraltet sein, wenn sich das Benutzerprofil danach ändert.
46+
Für die aktuellsten Informationen verwende die zweite Methode unten oder rufe `clearAllTokens()` auf und starte einen Authentifizierungsablauf neu, um ein frisches ID-Token (ID token) zu erhalten.
4747

4848
```ts
4949
await logtoClient.clearAllTokens();
@@ -53,8 +53,8 @@ logtoClient.signIn({
5353
});
5454
```
5555

56-
Wenn die Sitzung noch gültig ist, wird der `signIn`-Aufruf ohne erneute Eingabe von Zugangsdaten zurück zu deiner App umleiten. Aus Sicht des Benutzers wird die App einfach aktualisiert und ein neuer ID-Token (ID token) wird im Hintergrund ausgestellt.
56+
Wenn die Sitzung noch gültig ist, leitet der `signIn`-Aufruf ohne erneute Eingabe von Zugangsdaten zurück zu deiner App. Aus Sicht des Benutzers wird die App einfach aktualisiert und im Hintergrund ein neues ID-Token (ID token) ausgegeben.
5757

58-
### 2. Benutzerinformationen vom `/oidc/me`-Endpunkt abrufen \{#2-fetch-user-info-from-the-oidc-me-endpoint}
58+
### Benutzerinformationen vom `/oidc/me`-Endpunkt abrufen \{#fetch-user-info-from-the-oidc-me-endpoint}
5959

6060
Du kannst auch `/oidc/me` anfragen, um Benutzerinformationen in Echtzeit im Organisationskontext zu erhalten. Rufe dazu die SDK-Methode `fetchUserInfo()` auf.

i18n/de/docusaurus-plugin-content-docs/current/end-user-flows/organization-experience/invite-organization-members.mdx

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ sidebar_position: 6
44

55
# Organisationsmitglieder einladen
66

7-
In Multi-Organisations-Anwendungen ist es eine häufige Anforderung, Mitglieder zu einer Organisation einzuladen. Diese Anleitung führt durch die Schritte und technischen Details zur Implementierung dieser Funktion.
7+
In Multi-Tenancy-Anwendungen ist es eine häufige Anforderung, Mitglieder zu einer Organisation einzuladen. Diese Anleitung führt durch die Schritte und technischen Details zur Implementierung dieser Funktion.
88

99
## Ablaufübersicht \{#flow-overview}
1010

@@ -17,21 +17,21 @@ sequenceDiagram
1717
Participant C as Deine Multi-Organisations-App
1818
Participant L as Logto
1919
20-
A ->> C: Eingabe der E-Mail-Adresse und Rolle des Eingeladenen
20+
A ->> C: E-Mail und Rolle des Eingeladenen eingeben
2121
C ->> L: Organisationseinladung mit Management API erstellen
22-
L -->> C: Rückgabe der Einladungs-ID
23-
C ->> C: Einladungslink mit Einladungs-ID erstellen
22+
L -->> C: Einladung-ID zurückgeben
23+
C ->> C: Einladungslink mit Einladung-ID erstellen
2424
C ->> L: Anfordern des Versands der Einladungsemail mit Einladungslink
25-
L -->> U: Versand der Einladungsemail mit Einladungslink
26-
U ->> C: Klick auf den Einladungslink und Weiterleitung zu deiner Landingpage,<br /> Einladung annehmen oder ablehnen
27-
C ->> L: Aktualisierung des Einladungsstatus mit Management API
25+
L -->> U: Einladungsemail mit Einladungslink senden
26+
U ->> C: Klick auf Einladungslink und Weiterleitung zu deiner Landingpage,<br /> Einladung annehmen oder ablehnen
27+
C ->> L: Einladungsstatus mit Management API aktualisieren
2828
```
2929

3030
## Organisationsrollen erstellen \{#create-organization-roles}
3131

3232
Bevor Mitglieder eingeladen werden, erstelle Organisationsrollen. Siehe die [Organisationstemplate](/authorization/organization-template), um mehr über Rollen und Berechtigungen zu erfahren.
3333

34-
In dieser Anleitung erstellen wir weiterhin zwei typische Organisationsrollen: `admin` und `member`.
34+
In dieser Anleitung erstellen wir zwei typische Organisationsrollen: `admin` und `member`.
3535

3636
Die `admin`-Rolle hat vollen Zugriff auf alle Ressourcen der Organisation, während die `member`-Rolle eingeschränkten Zugriff hat. Zum Beispiel:
3737

@@ -82,15 +82,20 @@ Falls du die Logto Management API noch nicht eingerichtet hast, siehe [Mit Manag
8282

8383
### Organisationseinladung mit Logto Management API erstellen \{#create-an-organization-invitation-with-logto-management-api}
8484

85-
Es gibt eine Reihe von einladungsbezogenen Management APIs im Organisations-Feature. Mit diesen APIs kannst du:
85+
Im Organisations-Feature gibt es eine Reihe von einladungsbezogenen Management APIs. Mit diesen APIs kannst du:
8686

8787
- `POST /api/organization-invitations`: Eine Organisationseinladung mit zugewiesener Organisationsrolle erstellen.
8888
- `POST /api/one-time-tokens`: Ein Einmal-Token für den Eingeladenen erstellen, um sich zu authentifizieren, wenn er die Einladung annimmt. [Mehr erfahren](/end-user-flows/one-time-token)
8989
- `POST /api/organization-invitations/{id}/message`: Die Organisationseinladung per E-Mail an den Eingeladenen senden.
90-
Hinweis: Die Nutzlast unterstützt eine `link`-Eigenschaft, sodass du deinen eigenen Einladungslink basierend auf der Einladungs-ID erstellen kannst. Zum Beispiel:
9190

92-
```json
93-
{
94-
"link": "https://your-app.com/invitation/join?id=your-invitation-id&token=your-one-time-token&email=invitee-email"
95-
}
96-
```
91+
:::note
92+
93+
Das Payload unterstützt eine `link`-Eigenschaft, sodass du deinen eigenen Einladungslink basierend auf der Einladung-ID erstellen kannst. Zum Beispiel:
94+
95+
:::
96+
97+
```json
98+
{
99+
"link": "https://your-app.com/invitation/join?id=your-invitation-id&token=your-one-time-token&email=invitee-email"
100+
}
101+
```

i18n/de/docusaurus-plugin-content-docs/current/end-user-flows/organization-experience/join-the-organization.mdx

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,11 @@ sidebar_position: 7
66

77
## Wo wird es verwendet \{#where-to-use-it}
88

9-
Die Organisationsliste erscheint typischerweise während des Benutzer-Onboarding-Flows. Zum Beispiel, wenn ein Administrator dich einlädt, einem Arbeitsbereich beizutreten.
9+
Die Organisationsliste und der Beitrittsprozess erscheinen in der Regel während des Benutzer-Onboardings.
10+
Zum Beispiel, wenn ein Administrator jemanden zu einem Arbeitsbereich einlädt, der Benutzer jedoch die E-Mail-Einladung überspringt und sich direkt in der App anmeldet oder registriert.
1011

11-
Aus Produktsicht kann sie an zwei Hauptstellen erscheinen:
12+
In deinem Produkt möchtest du möglicherweise Einstiegspunkte für diesen Ablauf hinzufügen.
13+
Er kann an zwei Hauptstellen erscheinen:
1214

1315
- Der **Organisationsfinder** während der Anmeldung oder Registrierung
1416

@@ -24,12 +26,12 @@ Aus Produktsicht kann sie an zwei Hauptstellen erscheinen:
2426
alt="Organisation innerhalb der App beitreten"
2527
/>
2628

27-
## Die Logto Management API verwenden, um Benutzern das Beitreten zu einer Organisation zu ermöglichen \{#use-the-logto-management-api-to-let-users-join-an-organization}
29+
## Verwende die Logto Management API, um Benutzern den Beitritt zu einer Organisation zu ermöglichen \{#use-the-logto-management-api-to-let-users-join-an-organization}
2830

2931
Im vorherigen Abschnitt haben wir das Erstellen und Versenden von Organisationseinladungen mit der Logto Management API behandelt.
3032
Als Nächstes implementierst du eine Landingpage, die den Einladungslink verarbeitet, wenn Eingeladene in deiner Anwendung ankommen.
3133

32-
- `GET /api/organization-invitations` und `GET /api/organization-invitations/{id}`: Hole alle Einladungen oder eine bestimmte Einladung per ID.
34+
- `GET /api/organization-invitations` und `GET /api/organization-invitations/{id}`: Alle Einladungen oder eine bestimmte Einladung per ID abrufen.
3335
Verwende diese APIs auf deiner Landingpage, um alle Einladungen aufzulisten oder die Details einer bestimmten Einladung anzuzeigen, die der Benutzer erhalten hat.
34-
- `PUT /api/organization-invitations/{id}/status`: Akzeptiere oder lehne die Einladung ab, indem du ihren Status aktualisierst.
35-
Verwende diese API, um auf die Antwort des Benutzers zu reagieren.
36+
- `PUT /api/organization-invitations/{id}/status`: Die Einladung annehmen oder ablehnen, indem der Status aktualisiert wird.
37+
Verwende diese API, um die Antwort des Benutzers zu verarbeiten.

0 commit comments

Comments
 (0)