Skip to main content
All CollectionsIntegrationsActive Directory
Adding an App in Entra ID® - Single Sign-On Integration (SSO)
Adding an App in Entra ID® - Single Sign-On Integration (SSO)
Paul Sullivan avatar
Written by Paul Sullivan
Updated over 3 months ago

In this article

NOTE: Some images may refer to Microsoft® Entra ID as 'Active Directory'

Overview

To sync the Single Sign-On (SSO) integration, you will first need to set up an app within the Identity Provider (IDP). The steps for setting up an app differ depending on the IDP your company is using.

The Single Sign-On (SSO) integration allows you to set up a single username (ID) and password to sign into multiple software applications.

The SSO integration feature is an optional add-on. For further information regarding pricing and activation, please contact your customer success manager.

Adding an App in Entra ID

Coconut Software recommends you download the Coconut Calendar metadata file from Coconut Calendar before adding an app in Entra ID. You will need the information in the metadata file as part of the Entra ID app setup.

NOTE: For Unique User Identifier, select user.mail and NOT user.principalname.

For more information, refer to the Integrate Single Sign-On (SSO) with Coconut article.

Navigation

  1. Navigate to the Browser on your Personal Computer (PC)

  2. Navigate to portal.azure.com

  3. Enter your Microsoft username (email, phone, etc.) in the Username field

  4. Click Next

  5. Enter your Microsoft password in the Password field

  6. Click Next

  7. The Microsoft Azure Home screen will appear

  8. Click on the Entra ID icon
    ​

    MicrosoftAzureHome-ADlink.png

    Entra ID Icon
    ​

  9. Click on the Enterprise Application link under Manage on the Menu bar
    ​

    ActiveDirectory-EnterpriseApplications.png

    Enterprise Application Link
    ​

  10. Click on the + New Application button.
    ​

    EnterpriseApplication-NewApplication.png

    + New Application Button
    ​

  11. Click on the + Create your own application button
    ​

    Azure_AD_Gallery-create.png

    + Create Your Own Application Button

App creation

  1. Enter the name of the new application in the What's the name of your app? field
    ​

    createyourownapplication-name.png

    What's the Name of Your App Field
    ​

  2. Select Integrate any other application you don't find in the gallery

  3. Click Create

Uploading a metadata file

  1. Click on the Set up single sign on tile under Getting Started
    ​

    setupsinglesignontile.png

    Set Up Single Sign On Tile
    ​

  2. Click on the Security Assertion Markup Language (SAML) tile

    • SAML is an authorization language that is used to share user credentials (information) across multiple platforms (applications)

    • Coconut Calendar's SSO integration uses SAML 2.0 to connect the integration
      ​

    Singlesignonmethod-SAMLTile.png

    SAML Tile
    ​

  3. Click Upload metadata file

    • NOTE: You will need the metadata file from Coconut Calendar that is downloaded as part of the integration setup

  4. Click on the Upload File icon
    ​

    uploadmetadatafile-uploadfile.png

    Upload File Icon
    ​

  5. Select the Coconut Calendar metadata file from the connect personal computer (PC)
    ​

    selectmetadatafile.png

    Select Metadata File

  6. The Upload Metadata File screen will reload with the selected Coconut Calendar metadata file loaded
    ​

    Uploadmetadatafile-file.png

    Upload Metadata File Screen
    ​

  7. Click on the Add button to upload the Coconut Calendar metadata file to the Entra ID app
    ​

    Uploadmetadatafile-Add.png

    Add Button
    ​

  8. The Basic SAML Configuration screen will appear on the left side of the screen

    • A Confirmation pop-up screen will appear, indicating that the metadata file was successfully uploaded

  9. Click Save to save the metadata information to the Entra ID app
    ​

    BasicSAMLConfiguration-save.png

    Save Button

  10. Click on the x button in the top right-hand corner of the Basic SAML Configuration screen to close the screen and return to the Set up Single Sign On with SAML Screen
    ​

    BasicSAMLConfiguration-xbutton.png

    X Button
    ​

  11. The Test Single Sign-On screen will appear, click on the No, I'll test later button

    • You will need to download the metadata file from Entra ID and upload the credentials to Coconut Calendar
      ​

    testsinglesignon-nobutton.png

    No, I'll Test Later Button

Downloading the metadata file

  1. The Set up Single Sign-On with SAML screen will appear

  2. Scroll down to the SAML Signing Certificate section and click on the Download link next to Federation Metadata XML

  3. Download the certification file to the connected Personal Computer (PC)

    • The certification file will be used to sync Entra ID to Coconut Calendar
      ​

    SAML_Signing_Certificate_Section.png

    SAML Signing Certificate Section
    ​

  4. Scroll down to the Set up (Add Name) section and write down/record the data/information in the Login URL, Entra ID Identifier, and Logout URL fields

    • This information will be used to sync Entra ID to Coconut Calendar

    SAML_Signing_Certificate_Section2.png

    Metadata Information Fields

Entra ID to Coconut Calendar field-to-field

  • Login URL = SSO URL

  • Entra ID = Entity ID

  • Logout URL = SLO URL

  • Federation Metadata XML = x509 Certificate

Continue to Coconut Software to connect the SSO integration. For further information, refer to the Integrate Single Sign-On (SSO) with Coconut article.

A note on access and visibility

Administrators in Coconut have access to Entra ID.

Related Articles
Connect Microsoft® Entra ID to Coconut
Microsoft® Entra ID: FAQ
Disconnect Microsoft® Entra ID
Configure SSO role mapping
Integrate Single Sign-On (SSO) with Coconut
Did this answer your question?