How-to
      Back to home
      1. Knowledge Base
      2. How-to

      How to implement Microsoft Entra SSO for your PDPworks account

      Secure one-click access for Enterprise plans

      Enjoy secure one-click access to your my.PDPworks.com account dashboard from your organization's employee portal (https://www.my.pdpworks.com/sso?domainName=yourDomain).

       

      Three easy steps to implement SSO

      1. Review What to expect ↓
      2. Ask your Microsoft (MS) administrator to Create a Microsoft Entra Enterprise Application ↓
      3. Request SSO Account Activation ↓

       

      1 | What to expect

      After your Microsoft Enterprise application is created and PDP has completed your request to enable your my.pdpworks.com account for SSO:

      1. Existing my.pdpworks.com users can either 
        1. enter their Microsoft (MS) username (email address) at https://www.my.pdpworks.com and if they are currently logged in to their MS account they will be taken directly to their PDPworks Dashboard, or they will be required to first login to their MS before being presented their PDPworks Dashboard, or
        2. click a my.pdpworks.com link or button configured in their organization's portal and if they are currently logged in to their MS account they will be taken directly to their PDPworks Dashboard, or they will be required to first login to their MS before being presented their PDPworks Dashboard.

      While SSO is enabled, existing my.pdpworks.com users will no longer be required nor able to login using their my.pdpworks.com password.

      1. New my.pdpworks.com users can either
        1. enter their Microsoft (MS) username (email address) at https://www.my.pdpworks.com and if they are currently logged in to their MS account they will be taken directly to their PDPworks Dashboard (Personal Access > My Courses), or they will be required to first login to their MS before being presented their PDPworks Dashboard, or
        2. click a my.pdpworks.com link or button (https://www.my.pdpworks.com/sso?domainName=yourDomain) configured in their organization's portal and if they are currently logged in to their MS account they will be taken directly to their PDPworks Dashboard (Personal Access > My Courses), or they will be required to first login to their MS before being presented their PDPworks Dashboard, or
        3. for organizations utilizing PDPworks eLearning Enrollment links, following an enrollment link will present the my.pdpworks.com login page where the user will enter their MS username (email address), and if they are currently logged in to their MS account they will be taken directly to their PDPworks Dashboard (Personal Access > My Courses), or they will be required to first login to their MS account before being presented their PDPworks Dashboard.

      Important

      For all users new to my.pdpworks.com, the SSO process will automatically create a user in the organization's my.pdpworks.com account. 

      Note

      When SSO is implemented on an account, existing eLearning Enrolment links will still function but are deprecated due to the automatic creation of users in my.pdpworks.com. The ability to create a new eLearning link will be disabled. Simply sending eLearning users to https://www.my.pdpworks.com or https://www.my.pdpworks.com/?domainName=yourDomain.com will provide the same result. 

       

      2 | Create a Microsoft Entra Enterprise application

      1. In your organization's Microsoft Entra account (https://entra.microsoft.com), create a new enterprise application.

        client-ms-pdpworks-sso-setup-01-1

        client-ms-pdpworks-sso-setup-02
      2. Provide a name for the application and select "Integrate any other application you don't find in the gallery (Non-gallery)."

        client-ms-pdpworks-sso-setup-03
      3. Click the Create button.

        client-ms-pdpworks-sso-setup-04

        client-ms-pdpworks-sso-setup-06
      4. Select App registrations from the left fly-out

        client-ms-pdpworks-sso-setup-07
      5. Click on your new application

        client-ms-pdpworks-sso-setup-08
      6. Click Add a certificate or secret

        client-ms-pdpworks-sso-setup-09
      7. At Certificates & secrets, click New client secret

        client-ms-pdpworks-sso-setup-10
      8. Provide a description and select an option for Expires and click the Add button.

        client-ms-pdpworks-sso-setup-11
      9. Be sure to take note of the expiration date.

        client-ms-pdpworks-sso-setup-12

      10. At Enterprise applications | All applications, select your application under Manage and select Single sign-on. For Sign on URL enter https://sso.pdpworks.com/redirect and click the Save button.

        client-ms-pdpworks-sso-setup-13
      11. After SSO has been enabled for your my.pdpworks.com account, as MS administrator, test the SSO functionality and click the Accept button on the Permissions modal on behalf of your organization. This will ensure single-click access for the rest of your users.

      3 | SSO Account Activation

      Send a request to support@pdpglobal.com and ask that your my.pdpworks.com Enterprise account be enabled for SSO. Include the following details in your request:

      1. Your organizations name
      2. Your name and role in your organization
      3. Name and email address of your Microsoft Global Administrator or authorized Entra (formerly Azure AD) administrator if other than yourself.
      4. Your organization's Microsoft verified domain (e.g., company.com)
      5. Desired date and time for activation.