Wiki-Quellcode von OAuth 2
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
1 | {{content/}} | ||
2 | |||
3 | Auf der Oberfläche zur Konfiguration eines dem //OAuth 2//-Standard folgenden Identity Providers werden die folgenden Parameter abgefragt: | ||
4 | |||
5 | == Grundeinstellungen == | ||
6 | |||
7 | {{figure image="oauth_base_settings_en.png" clear="h1"}} | ||
8 | Grundeinstellungen für die Konfiguration eines neuen OAuth 2 Identity Providers. | ||
9 | {{/figure}} | ||
10 | |||
11 | === Name | ||
12 | |||
13 | Bezeichnung des Identity Providers in {{formcycle/}}. | ||
14 | |||
15 | === Abweichender Name auf dem Login-Button des Formulars | ||
16 | |||
17 | Wenn ein Formular so konfiguriert wurde, dass mehrere Authenthentifizierungsmöglichkeiten zur Auswahl stehen, wird beim Öffnen des Formulars ein Dialog angezeigt in dem man eine Authentifizierungsart wählen muss. Hier kann festgelegt werden, welcher Textinhalt auf dem Button für diesen Identity Provider stehen soll. | ||
18 | |||
19 | Wird an dieser Stelle nichts eingetragen, wird die unter //Name// eingetragene Bezeichung verwendet. | ||
20 | |||
21 | === Alias für Callback-URL (UUID) | ||
22 | |||
23 | Eindeutiger Identifikator, welcher der Identity Provider beim Rücksprung zu {{formcycle/}} verwendet. Dieser Wert wird automatisch generiert, kann bei Bedarf jedoch geändert werden. | ||
24 | |||
25 | === Callback-URL | ||
26 | |||
27 | Die beim Rücksprung vom Identity Provider zu FORMYCYLE verwendete URL wird hier angezeigt und kann über das Kopieren-Symbol rechts neben der URL in die Zwischenablage kopiert werden. Falls Frontend-Server vorhanden sind, wird auch für diese die entsprechende URL angezeigt. | ||
28 | |||
29 | |||
30 | == Initial sichtbare Schaltflächen | ||
31 | |||
32 | Unter den Grundeinstellungen befinden sich zunächst 3 Schaltflächen, deren Funktionen bei der Konfiguration des Identity Providers helfen sollen. | ||
33 | |||
34 | === E-Mail an Provider senden | ||
35 | |||
36 | Öffnet das im System eingerichtete E-Mail-Programm mit einer vorformulierten Anfrage bezüglich der für die Konfiguration des Identity Providers im {{formcycle/}} benötigten Informationen. | ||
37 | |||
38 | === Hilfe | ||
39 | |||
40 | Öffnet diese Hilfeseite im Browser. | ||
41 | |||
42 | === Konfiguration hinzufügen | ||
43 | |||
44 | Nachdem die benötigten Informationen vom Identitiy Provider bereitgestellt wurden, kann durch einen Klick auf diesen Button der Bereich für die Konfiguration des Identity Providers geöffnet werden. Es öffnet sich der im folgenden beschriebene Bereich //Konfiguration//. | ||
45 | |||
46 | == Configuration == | ||
47 | |||
48 | {{figure image="oauth_configuration_en.png" clear="h1"}} | ||
49 | Configuration options for an OAuth 2 identity provider. | ||
50 | {{/figure}} | ||
51 | |||
52 | === Key === | ||
53 | |||
54 | Unique ID of the configuration you get from your identity provider. | ||
55 | |||
56 | === Secret === | ||
57 | |||
58 | Secret key which is used to authenticate your client. | ||
59 | |||
60 | === Scope === | ||
61 | |||
62 | Specifies the access scope that FORMCYCLE uses when querying fields from the identity provider. | ||
63 | |||
64 | === Authorization Request URL === | ||
65 | |||
66 | Defines the URL which is used for an authorization request from the identity provider. | ||
67 | |||
68 | === Access-Token Request URL === | ||
69 | |||
70 | Defines the URL that is used to request the access token from the identity provider. | ||
71 | |||
72 | === URL to determine the profile data === | ||
73 | |||
74 | Defines the URL which is used to request the (user) profile data from the identity provider. | ||
75 | |||
76 | === Request method for determining the profile data === | ||
77 | |||
78 | Defines the request method (GET or POST) which is used for the request to receive the profile data from the Identity Provider. | ||
79 | |||
80 | === Attribute name for unique identifier in profile data === | ||
81 | |||
82 | Overrides the attribute name for the identifier in the returned profile data. The default value is "id". | ||
83 | |||
84 | == Mapping of the profile attributes to FORMCYCLE user profile == | ||
85 | |||
86 | {{figure image="oauth_extended_settings_en.png" clear="h1"}} | ||
87 | Advanced settings for configuring an OAuth 2 identity provider. | ||
88 | {{/figure}} | ||
89 | |||
90 | === Given name === | ||
91 | |||
92 | Specifies which profile attribute should be used for the user's first name. | ||
93 | |||
94 | === Last name === | ||
95 | |||
96 | Specifies which profile attribute should be used for the user's last name. | ||
97 | |||
98 | === Display name === | ||
99 | |||
100 | Specifies which profile attribute should be used for the user's display name. | ||
101 | |||
102 | === Username === | ||
103 | |||
104 | Specifies which profile attribute should be used for the user name of the user. | ||
105 | |||
106 | === Email === | ||
107 | |||
108 | Specifies which profile attribute should be used for the user's email address. | ||
109 | |||
110 | === Language === | ||
111 | |||
112 | Specifies which profile attribute should be used for the user's language. (Value must correspond to a code from ISO standards 3166 or 639.) | ||
113 | |||
114 | === Location === | ||
115 | |||
116 | Specifies which profile attribute should be used for the user's location. (Value must correspond to a code from ISO standards 3166 or 639.) | ||
117 | |||
118 | === Picture URL === | ||
119 | |||
120 | Specifies which profile attribute should be used for the user's picture URL. (Value must be convertible to a valid URI.) | ||
121 | |||
122 | === Profile URL === | ||
123 | |||
124 | Specifies which profile attribute should be used for the user's profile URL. (Value must be convertible to a valid URI.) | ||
125 | |||
126 | === Extended attribute mapping === | ||
127 | |||
128 | In addition to the ones listed above, other attributes can be defined in this table. A property and a corresponding value must be entered in each line. |