Last edited 4 months ago
by Meryam Sahin

Establish Connection

On Entra

Click on Enterprise Application:

Click New Application:

File:Setup Draft Setup Azure-OpenIDConnect New.png

Click Create your own Application:

File:Setup Draft Setup Azure-OpenIDConnect create.png

Choose a distinct name,

Select Register an application to integrate with Microsoft Entra ID (App you're developing)
File:Setup Draft Setup Azure-OIDC-Connection create.png
File:Setup Draft Setup Azure-OIDC-Connection create2.png
File:Setup Draft Setup Azure-OIDC-Connection setup1.png

Click create. Choose Supported Accounts(Mostly just first)

Click register. Go back to EnterpriseApplications andsearch for newly created Application and click it:

File:Setup Draft Setup Azure-OIDC-Connection setup2.png

Click SingleSign-On and Edit Attributes & Claims:


Choose add Claim. Name the Claim DistinctUserName. Choose transformation ExtractMailPrefix()

and use Source-Attribute: user.userprincipalname.

File:Setup Draft Setup Azure-OIDC-Connection name claim.png


Click add and save:

Close InWindow Attribute & Claims and choose GotoApplication:

File:Setup Draft Setup Azure-OIDC-Connection setup4.png


Choose Add Redirect Uri:

File:Setup Draft Setup Azure-OIDC-Connection uri1.png



Click Add a Platform and choose Web:

File:Setup Draft Setup Azure-OIDC-Connection uri2.png


Add URL and save:

File:Setup Draft Setup Azure-OIDC-Connection uri3.png


This entry needs to be the Complete URL to the Page Special:PluggableAuthLogin:

https://my.cool.bluespice.url/wiki/Special:PluggableAuthLogin

And it depends on the WikiLanguage, so for German:

https://my.cool.bluespice.url/wiki/Spezial:PluggableAuthLogin

after saving here you can add several more(needed for FarmInstallation .):

File:Setup Draft Setup Azure-OIDC-Connection uri4.png

click save.

Go to Manifest :

File:Setup Draft Setup Azure-OIDC-Connection manifest.png


and change Value for "acceptMappedClaims" to:

"acceptMappedClaims": true

Clikc Save. Go back to overview and choose Add a certificate or secret:

File:Setup Draft Setup Azure-OIDC-Connection secret1.png
File:Setup Draft Setup Azure-OIDC-Connection secret2.png

Choose Add Secret, name it and chose expiry date(24 Month) is max. Click Add.

The Secret has a Value and an ID. Nobody cares about the ID, please copy/save Value for later.

File:Setup Draft Setup Azure-OIDC-Connection secret3.png

Go back to Overview:

File:Setup Draft Setup Azure-OIDC-Connection setup.png

Fill jsonstring with Value:

{"clientID":">>CLIENT_ID_STRING<<","clientsecret":">>SECRET_VALUE_STRING<<","preferred_username":"DistinctUserName","providerURL":"https://login.microsoftonline.com/>>TENNANT_ID_STRING<<</v2.0/"}

On Wiki

Go to

https://my.cool.bluespice.url/wiki/Special:BlueSpiceConfigManager

File:Setup Draft Setup Azure-OIDC-Connection configManager.png

Wat

Pluggable Auth Entries:
Name Value Usage
Button Label Free String Just a Identifier for the Login Button. Usefull if you have several Authentication Providers
PluginName "OpenIDConnect" Tells BlueSpice what plugin to use
Data object json-string Tells BlueSpice the Sources of the UserInformation
Group object string json-string Tells BlueSpice about groupsync configuration

Click Add , check the Chekbox"Should login occur automatically when a user visits the wiki?", and after that click Save.

Open Wiki in a New Browser or Private Session:

File:Setup Draft Setup Azure-SAML-Connection Login.png


Enable Auto-Login:

Step 1: Enable AutoForwarding to LoginPage

File:Setup Draft Setup PluggableAuth-Login-Page.png

Step2: Disable LocalLogin:

Set:

<?php
$GLOBALS['wgPluggableAuth_EnableLocalLogin'] = false;

in post-init-settings.php

See also:

https://www.mediawiki.org/wiki/Extension:PluggableAuth

https://www.mediawiki.org/wiki/Extension:OpenID_Connect