You are here

README.txt in OpenID Connect Microsoft Azure Active Directory client 2.0.x

Same filename and directory in other branches
  1. 8 README.txt
  2. 7 README.txt
OPENID CONNECT WINDOWS AAD
==========================

This small module is a CTools plugin for the great module OpenID Connect and
focuses on integration with Windows Azure AD.

Basically, Windows Azure AD connection can be achieved by using the Generic
client in OpenID Connect. Unfortunately, Windows Azure does not support the use
of the regular JWT access tokens. When we want to retrieve the UserInfo (email
address, name), we need to do a separate request and map the results on existing
fields for the user.

This module uses the access token to do this second request to Windows Azure
AD, resulting in the UserInfo data. It will also check if an email address is
part of the UserInfo data. In case no email is there, it will still create the
user, but use the username instead, providing a notice to prompt the user to
change it in his/her user settings.

Setup
-----

* Install this module.
* Visit the OpenID Connect config page: admin/config/services/openid-connect.
* Windows Azure AD will be available as a client.

Requirements
------------

* Drupal OpenID Connect module
* Windows Azure Active Directory endpoints from your registered application

External sources
----------------

* http://stackoverflow.com/questions/28631635/
* https://www.drupal.org/node/2682135

File

README.txt
View source
  1. OPENID CONNECT WINDOWS AAD
  2. ==========================
  3. This small module is a CTools plugin for the great module OpenID Connect and
  4. focuses on integration with Windows Azure AD.
  5. Basically, Windows Azure AD connection can be achieved by using the Generic
  6. client in OpenID Connect. Unfortunately, Windows Azure does not support the use
  7. of the regular JWT access tokens. When we want to retrieve the UserInfo (email
  8. address, name), we need to do a separate request and map the results on existing
  9. fields for the user.
  10. This module uses the access token to do this second request to Windows Azure
  11. AD, resulting in the UserInfo data. It will also check if an email address is
  12. part of the UserInfo data. In case no email is there, it will still create the
  13. user, but use the username instead, providing a notice to prompt the user to
  14. change it in his/her user settings.
  15. Setup
  16. -----
  17. * Install this module.
  18. * Visit the OpenID Connect config page: admin/config/services/openid-connect.
  19. * Windows Azure AD will be available as a client.
  20. Requirements
  21. ------------
  22. * Drupal OpenID Connect module
  23. * Windows Azure Active Directory endpoints from your registered application
  24. External sources
  25. ----------------
  26. * http://stackoverflow.com/questions/28631635/
  27. * https://www.drupal.org/node/2682135