Skip to main content

Configuration of Willba's SAML Identity Provider

This document outlines the process for configuring Willba's SAML identity provider using Google Workspace. The configuration process is divided into phases:

Step 1: App Setup​

  1. Navigate to the Google Workspace Admin Panel.
  2. Select Apps from the side menu, then click on Web and mobile apps.
  3. Click on the Add app button.
  4. In the dropdown menu that appears, select Add custom SAML app.

Create SAML Application

Step 2: App Configuration​

  1. Name your new app Willba.
  2. Click Continue to proceed to the next step.
  3. Download the metadata file. This file will be needed for communication between Willba and Google Workspace, so ensure you store it securely.

Download Metadata

  1. Share the downloaded metadata file with your Willba contact person.
  2. Click Continue to move to the next step.

SAML Application Settings

  1. Configure the SAML settings with the following values:
    • ACS URL: https://auth.willba.app/realms/{realm-name}/broker/saml/endpoint
    • Entity ID: https://auth.willba.app/realms/{realm-name}
tip

Replace {realm-name} with the value provided by your Willba contact person.

  1. Map the attributes as follows: firstName, lastName, email (see image below for reference).
  2. Click Finish to complete the app configuration.

Set Attributes

Step 3: User Access Setup​

  1. Navigate to User Access within the app settings.
  2. Set the application status to ON for everyone.
  3. Click Save to apply the changes.

This process allows all users in your Google Workspace to access Willba via SSO (Single Sign-On) functionality.

Step 4: Finalization​

The login will work after the Willba contact person adds the SAML settings to the application.

Make sure to test the setup with a few users to confirm everything is working as expected. If you encounter any issues, please reach out to your Willba contact person.