EXT: OpenID¶

Table of Contents¶

EXT: OpenID 1

Introduction 2

What does it do? 2

Requirements 2

Screenshots 2

Users manual 4

Configuration 5

Installation 5

TypoScript Reference 5

Fields provided by OpenID (“sreg definition”) and their mapping to TYPO3 7

Tutorial 7

Known problems 7

Current limitations 7

Pitfalls to avoid 7

TODO 8

Introduction¶

Users manual¶

The OpenID frontend plugin has two modes:

• Login mode – provides OpenID login form (plus the follow-up “First- Time OpenID” dialog; see above)
• Edit mode – allows authenticated users to edit their OpenID associations [not yet described in this documentation]

Figure 3: Insert plugin OpenID

OpenIDs records are stored in a sysfolder. If OpenID creates new frontend user records, these are of stored in the same sysfolder. See TypoScript Reference for details.

Figure 4: Users and OpenIDs stored in the backend

Configuration¶

Tutorial¶

This is an step-by-step example for a simple but nice OpenID integration on your web site.

• Make sure curl is available on your server
• Install the extension naw_openid
• Place the OpenID frontend plugin e.g. underneath your regular logon box. Set it to “loginbox” mode.
• For user convenience: Create an extra page named “First-Time OpenID”, set it to “not in menu”, and remember the page's ID. Sample value: 188
• Also place the OpenID frontend plugin on the “First-Time OpenID” page, an also set it to “loginbox” mode.
• Define where you want new OpenID records to be stored (you may want to create one or use your normal fe_user sysfolder), and remember that sysfolder's ID.Note: In this example, OpenID-created users are allowed, and will be stored in the same folder as the OpenID records. In other cases you may want to disallow automatic user creation through OpenID. Sample value: 189
• Find out the ID of other sysfolders where fe_users are stored that are allowed to be associated to OpenID identities. Sample value: 67,165
• Decide what user group OpenID-created users should belong to, and remember that group's ID. Sample value: 5
• Include the naw_openid static template, and edit your TypoScript Setup:

plugin.tx_nawopenid_pi1 {
        fe_user_pid = 67,165,189
        fe_user_pid_create = 189
        DefaultUsergroupNewUser = 5
        responsePageUIDfromOpenIDServer = 188
}

Done!

You may also want to edit your HTML template, especially if you want to link to an own explanation page.

For further and more detailed configuration options, see the TypoScript section above.

Also consider providing edit capabilities to the users by placing the OpenID plugin in edit mode at an appropriate location.

Known problems¶

TODO¶

• Documentation of “OpenID management” mode
• OpenID for backend users
• Customizable field OpenID mapping (e.g. to tt_address fields)
• Email notification, e.g. when a new user was created
• Semi-automatic OpenID user creation (i.e. with administrative clearing)

EXT: OpenID - 8