Guide Index
Guides HomeMangoApps WebsiteCommunity & SupportBlog & Resources
MangoApps Administrators Guide
MangoApps Administrators Guide
  • 🥭MangoApps Admin Guides
  • 🆕Admin Portal Navigation Bar
    • Recommendations
      • Increase Findability
  • Home
    • Dashboard
    • Pending Invites
    • Pending Approvals
    • Logs
      • Audit Log
      • User Access Log
      • Assistants Log
      • Security Log
      • Connector Log
      • Imports Log
      • Learn Automations Log
      • xAPI Activity Log
      • Webhook Log
      • Debug Log
      • Schedule Sync Log
    • Trash Can
      • Trash Can Tools
      • Trash Can Widget
    • Data Exports
  • 🆕Domain Setup
    • General Settings
    • Getting Started
      • Introduction Video
      • Terms of Service/ Privacy Policy
      • Change Password
      • Profile Items
      • Locale
      • Team Recommendations
      • Notifications
      • Invite
    • AI Settings
    • Page Templates
      • Design a Page Template
    • Locale
    • Digital Signage
    • Translate
      • Translate Modules
      • Glossary
      • Translate Settings
    • Startup Dialog
    • 🆕Reactions
    • Compose
    • 🆕Locations
      • 🆕General Settings
      • Locations
        • Adding an Office Location
      • Location Fields
      • Location Summary
      • Webhooks
    • 🆕Field Structures
      • Field Member Automation
      • 🆕Field Hierarchy Sync
    • Holidays
    • Companies
    • Resources
    • Service Usage
    • 🆕My Priority Items
  • 🆕User Management
    • Manage Users
    • Add Users
      • Invite Users
      • Import Users
        • Synchronize Users From ADP
      • Synchronize Users From AD/LDAP
      • Fetch From URL
      • Share Sign Up Link
      • Import Via API
    • Organizations
    • Admin Roles
      • Admin Role Permissions
    • User Segments
    • Team Segments
    • Assistants
    • 🆕Alias
    • 🆕User Status
    • Guest Users
      • Create a Guest User
    • Restricted Users
  • 🆕Modules
    • Ballots
    • Calendar
      • Calendar Event Types
      • Calendar Settings
      • Calendar Integrations
    • Campaigns
      • Settings
      • Templates
      • Categories
    • Chats
    • Company
    • CRM
      • Setup
      • Stages
      • Types
      • Lead Sources
      • Opportunities Access
      • All Opportunities
      • More Options
    • Departments
    • 🆕Files
      • 🆕Settings
      • File Storage
      • External Repositories
      • Cloud Folders
      • 🆕Manage
      • Configure Custom Fields
      • 🆕Show/Hide File Fields
    • Greetings
      • Manage Greetings
      • Manage Categories
      • Settings
    • 🆕Groups
      • 🆕Automatic Membership Management
    • Hashtags
      • Manage Hashtags
      • Categories
      • Settings
    • 🆕Home
      • 🆕Dashboard Selection
        • 🆕Web
        • Mobile
      • Settings
    • Ideas
      • Manage Ideas
      • Idea Categories
      • Idea Settings
    • Libraries
    • Media Center
      • Settings
      • Categories
      • Media Card
      • Custom Fields
    • Messages
    • My Recordings
    • 🆕News Feed
      • General Settings
      • 🆕Left Panel Widgets
      • 🆕Right Panel Widgets
    • Notes
      • Settings
      • Templates
    • 🆕People
      • 🆕Settings
      • 🆕Full Profile
        • Managing Profile Fields
      • Profile Preview
      • People Directory
      • Org Chart
      • Skills
      • Webhooks
    • 🆕Posts
      • Settings
      • Content Template
      • Alert Template
      • Categories
      • 🆕AI Actions & Workers
    • Projects
      • Project Templates
    • Quizzes
    • Recognition
      • Settings
      • Data Sources
        • Add Data Source
          • Create Custom Items Tracker
          • Order History Tracker
      • Reward Catalog
      • Award Categories
      • Awards
      • Core Values
      • Reward Points Allocation
      • Order & User History
      • Recognition Insights
    • 🆕Schedules
      • Shift Data Source
        • Integration with Kronos
      • Tab Settings
        • Attendance Reports
      • 🆕Schedule Settings
      • Attendance Settings
      • Availability
    • Setup
    • 🆕Surveys
    • 🆕Tasks
      • 🆕Task Settings
      • Task Types
      • Task Priorities
      • Task Templates
      • Task Automations
      • Task Tabs
    • To Do
      • Settings
      • Sections
    • Trackers & Forms
      • Create a Tracker Template
      • Configure Tracker Settings
    • Vault
      • Employee Vaults
      • Integration
      • Audit
      • Folders
      • Settings
      • Vault Permissions
    • Wikis
  • 🆕Navigation
    • 🆕Add New Navigation
    • Navigation Styles
    • Add Custom Links
    • FAQ
  • 🆕Email
    • Configuration
    • Content
    • 🆕Digest
    • Accepted List
    • Rejected List
    • Unsubscribed Users
  • Notifications
    • Settings
    • Security Notification
    • External Apps
  • SSO
    • Connections
    • Applications
  • Search
    • Insights
    • Data Sources
    • Saved Searches
    • Relevance Tuning
    • Look Ahead Sections
    • Search Settings
  • Automation
  • 🆕Security
    • Browser Access
    • 🆕Desktop & Mobile Access
    • User Devices
    • Synced Computers
    • Password Settings
    • Session Settings
    • Virus Scan
  • Compliance
    • Accessibility
    • Delete Settings
    • Self Destruct
    • Data Retention
    • eDiscovery
      • Create a Hold
    • DLP Policies
      • Policy Rules
      • Matches Log
      • Create a DLP Policy
    • Terms of Service
    • Usage Policy
    • Email Compliance
    • Export Data
  • Moderation
    • Queue
    • Insights
    • Settings
  • 🆕Governance
    • Overview
    • Items
    • 🆕Automation
    • Archived
    • Settings
  • Social Advocacy
    • Social Advocacy Tools
    • Settings
    • Social Posts
    • Insights
    • Social Posts Sharing
  • Integrations
    • MangoApps Open APIs
    • Webhooks
  • Branding
    • Branding Toolbars
    • Portal
      • Custom Branding Colors
      • Home Page: Modern vs. Classic View
      • Text Styles
    • Content
    • Widgets
    • Profile
    • Footer
    • Email
    • Custom
      • Add a Custom Header
    • Image Recommendations
    • ⭐Branding Implementation Checklist
  • 🆕Reports
    • Reports Tools
    • Generate a Report
    • FTP Export
    • 🆕Report Settings
  • Analytics
    • Adoption Dashboard
    • ROI Dashboard
    • Engagement Dashboard
    • Content Dashboard
  • Billing & Invoices
    • Plan
    • Invoice
    • Settings
  • Help Center Setup
    • Settings
    • Admin Training Videos
    • User Training Videos
    • Webinars & Videos
    • Help Center
  • Sitemap
  • 🚫Deprecated Features By Release
    • 🚫Activities (Deprecated)
    • 🚫Landing Page (Removed)
    • 🚫MangoApps File Sync Guide (Deprecated)
      • 🚫File Sync (Deprecated)
        • 🚫File Sync Tools (Deprecated)
      • 🚫Installation & Upgrade (Deprecated)
      • 🚫My Drive Sync
      • 🚫Synced Files
      • 🚫Synced Preferences
      • 🚫Notifications
      • 🚫Team Sync
    • 🚫Screen Share (Deprecated)
      • 🚫Screen Share Tools
      • 🚫Screen Share (Messenger)
    • 🚫Screen Share/Video Call Log
    • 🚫Type-2 Organizations (Deprecated)
    • 🚫Voice (Moved)
  • ADDITIONAL RESOURCES
    • Submit a Support Ticket
    • Release Notes
Powered by GitBook
On this page
  • Adding a pre-configured SAML Application
  • Adding a custom SAML & OAuth2 Application
  1. SSO

Applications

Applications using MangoApps as the Identity Provider (IDP)

PreviousConnectionsNextSearch

Last updated 1 month ago

For information on specific SSO integrations, visit our Integrations Guide .

This section provides details on how to configure SAML 2.0 & OAuth2 applications to authenticate against MangoApps as an IDP or OAuth Provider.

1. List of configured applications: Displays a list of all the Admin configured applications.

2. Setup Instructions: A step-by-step instructions guide to integrate the respective application with MangoApps.

3. Manage Settings: Allows you to edit the existing configuration for the application.

4. Toggle Bar: Click the toggle bar to enable/disable the application.

5. Add Applications: You can choose from a list of 13 out-of-the-box widely used applications for quick configuration. Additionally, you can add a custom SAML or OAuth2 application.

Adding a pre-configured SAML Application

When configuring a SAML application, your application acts as the Relying Party/Service Provider (SP) that redirects browser traffic from the client to Mango App - IDP (Identity Provider) for authentication.

In Admin Portal, click on SSO then click on Applications. Click on ‘Add Application’. Select one of the preconfigured applications.

1. Confirm the Application label.

2. Verify the prepopulated values, viz. ACS URL & Entity ID of the SP (Service Provider).

3. Select the user identifier/nameid to be either Email or samAccountName or EmployeeID.

4. Use the SSO & SLO URL to configure the SP side settings.

Adding a custom SAML & OAuth2 Application

If you’d like to add applications that aren’t in our catalog, you can creare a custom application.

Custom SAML Application

The following steps are specific to the Custom SAML application and are required in order to enable SSO for Custom SAML.

1. Customize the Application Name and Logo to easily identify your Custom SAML app.

2. Select the Sign On method as SAML.

3. Enter ACS URL (Assertion Consumer Service). The endpoint where the SAML Response/Assertion from MangoApps is sent with a HTTP POST.

4. Enter a logout URL where users would be redirected after signing off from the custom application.

5. Enter an Entity ID from the SP (Service Provider) side. An entity ID is a globally unique name for a SAML entity. In this case it’s for the SP.

6. Select the user identifier, which is the NameID element in the SAML assertion.

7. Select the format of the identifier/NameID in the SAML assertion.

8. Select the type of User attributes to be sent to the application in SAML assertion.

9. Copy the ‘SSO URL’ and paste it on the SP side. This URL will serve the authentication requests sent by the clients.

10. Copy the ‘SLO URL’ where the application would send the logout request.

(Optional)

11. Enable advanced security to encrypt the SAML messages from MangoApps.

12. Select the algorithm to encrypt the SAML response.

13. Paste the application/SP with a x509 certificate.

14. Enter the Private Key to encrypt the SAML response.

15. Enter Pass key to access the Private key (if the Private key is password protected).

Custom OAuth2 Application

This topic covers how to add the custom OAuth2 Client application to the Admin Portal and describes the available configuration fields and options.

1. Customize the Application Name and Logo to easily identify your Custom SAML app.

2. Select the Sign On method as OpenID Connect/OAuth2.

3. Specify the application type that’ll be using OAuth2. Web application uses OAuth’s implicit grant while the Mobile application uses authorization code grant flow.

4. Enter the endpoint/s where MangoApps will send the OAuth responses. For multiple endpoints specify each endpoint on a new line.

5. Enter the URL where users would be redirected to after a logout.

6. App URL is explicitly required for the Mobile applications.

7. Copy the Discovery URL / OAuth2 metadata and use it while configuring the application side.

8. Select the type of User attributes to be sent to the application in SAML assertion.

9. (Optional) Use the ‘User Profile URL’ to fetch additional user attributes configured in MangoApps.

here