Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Resized images for readability.

Table of Contents

 


Introduction


Recently, there have been questions from customers, partners and the community asking for comparisons between Joget Workflow and Microsoft SharePoint. Actually, the two products are not competing, but in fact complement each other.

...

This article describes how SSO can be achieved using Active Directory Federation Services (https://msdn.microsoft.com/en-us/library/bb897402.aspx), which supports the Security Assertion Markup Language (SAML) standard.  


Configuring Joget Workflow SharePoint SSO

...

The appendices provide some resources on installing and configuring these pre-requisites.

 


ii. Configure SAML for Joget Workflow

...

  1. In the Windows Server Manager, launch Tools > AD FD Management
    Image Modified
  2. In the AD FS Management console, select Service > Certificates in the left navigation pane.
  3. Select the Token-signing certificate and click on the View Certificate link on the right pane. 
    Image Modified
  4. Click on the Details tab, and click on the Copy to File… button
    Image Modified
  5. This starts the Certificate Export Wizard. On the Welcome to the Certificate Export Wizard page, click Next.
  6. On the Export Private Key page, click No, do not export the private key, and then click Next.
  7. On the Export File Format page, select Base-64 encoded X.509 (.CER), and then click Next.
  8. On the File to Export page, type the name and location of the file that you want to export, and then click Next. For example, enter C:\ADFS.cer.
  9. On the Completing the Certificate Export Wizard page, click Finish.

...

  1. Download the SAML Directory Manager from the Joget Marketplace
  2. In Joget Workflow, login as an administrator
  3. In Settings > Manage Plugins, click on Upload Plugin. Select the downloaded JAR file and click on the Upload button to upload the downloaded JAR file
  4. In Settings > Directory Manager, choose the SAML Directory Manager and click on Select
    Image Modified
  5. Open the contents of the exported AD FS certificate in a text editor and copy the contents.
  6. In the Plugin Configuration page, paste the contents into the IDP Certificate field (copy-paste without the BEGIN and END lines) 
    Image Modified
  7. Copy the value of the ACS URL (to be used in AD FS configuration later).
  8. With User Provisioning Enabled checked, a user will be created on first login if the username does not already exist. To integrate with Active Directory directly to retrieve users and groups, configure the External Directory Manager to LDAP Directory Managerhttps://dev.joget.org/community/display/KBv5/LDAP+Directory+ManagerClick on Submit to save the settings.

iii. Configure Relying Party Trust between AD FS and Joget Workflow

...

  1. In the Windows Server Manager, launch Tools > AD FD Management
  2. In the AD FS Management console, click on Trust Relationships > Relying Party Trusts in the left navigation pane.
  3. In the right page, click on Add Relying Party Trust
    Image Modified
  4. On the Welcome to the Add Relying Party Trust Wizard page, click Start.
  5. Select Enter data about the relying party manually, and then click Next.
  6. Type a relying party name (e.g. Joget Workflow) and then click Next.
  7. Make sure Active Directory Federation Services (AD FS) 2.0 Profile is selected, and then click Next.
  8. Do not use an encryption certificate. Click Next.
  9. Click to select the Enable support for the SAML 2.0 WebSSO protocol check box.
  10. In the Relying party SAML 2.0 SSO service URL field, type the URL copied from the Joget SAML Directory Manager earlier, e.g. https://mysite.cloud.joget.com/jw/web/json/plugin/org.joget.plugin.saml.SamlDirectoryManager/service
  11. Paste the URL into the relying party trust identifier, and then click Add. Click Next.
  12. Select Permit all users to access this relying party. Click Next.
  13. On the Ready to Add Trust page, there is no action required, click Next.
  14. On the Finish page, click Close. This opens the Rules Editor Management console.

...

  1. On the Issuance Transform Rules tab, click Add Rule
    Image Modified
  2. On the Select Rule Template page, select Send LDAP Attributes as Claims. Click Next.
  3. On the Configure Rule page, type the name of the claim rule in the Claim rule name field e.g. User Attributes.
  4. From the Attribute Store drop-down list, select Active Directory.
  5. In the Mapping of LDAP attributes to outgoing claim types section, key in the following mappings: 

    LDAP Attribute

    Outgoing Claim Type

    SAM-Account-Name

    Name ID

    E-Mail-Addresses

    email

    Given-Name

    User.FirstName

    Surname

    User.LastName

    Image Modified

  6. Click Finish, and then click OK.
  7. At this point, the SSO should be operational. Test the login by accessing the the AD FS login page e.g. https://windows.local/adfs/ls/idpinitiatedsignon.aspx 
    Image Modified
  8. Select the appropriate site e.g. Joget Workflow and click on Sign in.
  9. Login to SharePoint using your AD account 
    Image Modified
  10. On successful login, you should be automatically logged into Joget Workflow 
    Image Modified

iv. Add Link in SharePoint site

  1. In SharePoint, click on Edit Links in the left menu 
    Image Modified
  2. Click on (plus) link, and key in the text to display (e.g. Joget Workflow) and the direct SSO link e.g. assuming the AD FS server is https://windows.local and the Joget Workflow server is https://mysite.cloud.joget.com, the link will be https://windows.local/adfs/ls/idpinitiatedsignon.aspx?logintoRP=https://mysite.cloud.joget.com/jw/web/json/plugin/org.joget.plugin.saml.SamlDirectoryManager/service 
    Image Modified
  3. Once the link is created, clicking on the link will SSO the user into the Joget Workflow installation.


...

  1. Options for installing Joget Workflow:
    1. Install On-Premise: https://dev.joget.org/community/display/KBv5/Installation Installation Guide
    2. Install on Docker:https://dev.joget.org/community/display/KBv5/Joget+Workflow+on+ Joget Workflow on Docker
    3. Install on OpenShift:https://dev.joget.org/community/display/KBv5/Joget+Workflow+on+ Joget Workflow on OpenShift
    4. Sign up for Joget Workflow On-Demand: https://cloud.joget.com

 

...