Wiki source code of Externe Benutzer


Show last authors
1 This feature is subject to costs. It allows the usage of external identity providers for the authentication of users in {{formcycle/}} forms.
2
3
4 {{content/}}
5
6 {{figure image="identity_provider_en.png" clear="h1"}}
7 Configuration interface while adding a new Identity Provider.
8 {{/figure}}
9
10 It is possible to configure Identity Providers here, which can be used to authenticate users in forms in this {{formcycle/}} [[client>>doc:Formcycle.SystemSettings.UserInterface.Clients]]. If an identity provider is supposed to be available in all clients, it can be configured in the [[System settings>>doc:Formcycle.SystemSettings.UserInterface.ExternalUsers.WebHome]] instead.
11
12 == Create new Identity Provider ==
13
14 By clicking on the {{ficon name="plus-circle-outline"/}} button in the upper left corner, a new Identity Provider can be created. At first 4 buttons appear, by which the type of identity provider must be selected. The following types of Identity Providers are available:
15
16 * [[OpenID Connect>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.openid]]
17 * [[SAML 2.0>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.saml]]
18 * [[OAuth 2>>Formcycle.UserInterface.UserSettings.ExternalUsers.oauth]]
19 * [[Facebook>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.facebook]]
20 * [[Google>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.google]]
21 * [[Azure AD>>Formcycle.UserInterface.UserSettings.ExternalUsers.azure]] {{version major="7" minor="1" /}}
22
23
24 The individual options for configuring these identity providers are described in detail on the linked subpages.
25
26 == Delete existing Identity Provider ==
27
28 After an entry has been selected in the list of identity providers, it is deleted by pressing the {{ficon name="trash-alt2"/}} button and confirming the dialog that opens.
29
30 == Use data of the logged in user in forms ==
31
32 The user data returned upon login can be used, among other things, to fill form fields. For this purpose, the placeholders [[[%$USER%]>>doc:Formcycle.UserInterface.Variables.WebHome||anchor="sec_user_variables"]], [[[%$LAST_USER%]>>doc:Formcycle.UserInterface.Variables.WebHome||anchor="sec_user_variables"]] and [[[%$INITIAL_USER%]>>doc:Formcycle.UserInterface.Variables.WebHome||anchor="sec_user_variables"]] can be set as values in form elements. Alternatively, this data can be accessed in JavaScript through the XFC METADATA object {{jsdoc page="metadata" name="user"/}}.