Add Express Application

This section provides step-by-step instructions for creating an Express application in Monokee. By following these instructions, you can instruct Monokee how to authenticate to an application or service using custom authentication mechanism. This will allow you to automate the authentication procedure for your users, simplifying and improving authentication process.

The following steps will guide you through the process of setting up an Express application:

1. Navigate to your Monokee custom fully qualified domain name (FQDN) or if you haven't set up a custom FQDN, go to Monokee's default page and enter your domain id. Then, enter your login credentials to access your account.

2. Open the left sidebar and select Applications from the menu.

3. This will display a list of applications. To create a new application, click the Add button located in the top right corner of the table. Then, select Express Application and click Add.

4. Monokee will open the General Configuration step. Refer to the generic section of the application documentation for instructions on how to configure this section.

5. Click Create to create your empty application and proceed to the Express Configuration step.

6. In the Preflight Function code area if needed you can insert a custom function. For example:

       // This example is useful to implement JUMP between different application 
       // implementing SSO and parameters exchange between apps.
   
       // Get the query string parameters from window.location
       let queryString = window.location.search;
       let urlParams = new URLSearchParams(queryString);
   
       // Extract needed parameters
       let params = { 
           orderNumber: urlParams.get("orderNumber"),
           invoiceNumber: urlParams.get("invoiceNumber")
       }
   
       // Return the parameters
       callback(params)

7. Set the Login URL and the HTTP method as needed. For example: https://marketplace.example.org/sso/complete-order and POST.

8. Set submit form or xhr as needed. In this example is used submit form.

   info

   In case of XHR the destination web server needs to have CORS enabled for Monokee base hostname or for your custom FQDN.

9. Set the login properties as needed. For example:

   Type	Property to be sent	Value	Hidden	Is Attribute	Editable	From Preflight	From Session	Encrypted
   email	email	userMail	☐	☑	☐	☐	☐	☐
   password	password	-	☐	☐	☑	☐	☐	☐
   text	order	orderNumber	☐	☐	☐	☑	☐	☐
   text	invoice	invoiceNumber	☐	☐	☐	☑	☐	☐

10. Click the bottom right corner Update button to save the configuration.

11. You can assign the application to a user as explained in the user management section and access the application using this url https://(new.monokee.com|<domain-custom-fqdn>)/app/express/sso?domain_id=<domain-id>&application_id=<application-id>. To retrieve the application id for a newly created application, you can visit the application's page and look at the last portion of the browser URL. The domain id parameter is mandatory only if you are using Monokee default hostname.