> ## Documentation Index
> Fetch the complete documentation index at: https://support.amplify.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# SWA App integrations

A SWA app integration provides **Single Sign-On (SSO)** to external applications that don't support proprietary federated sign-on methods. SWA works with any web-based application.

After you successfully create your SWA integration and assign it, end users can click the tile in their dashboard to launch your app. The username and password fields are populated, and the user signs in to the app automatically.

***

## Setup SWA App

Go to **Application > Create App Integration**.

<Frame>
  <img src="https://mintcdn.com/ifax/QElh_CM21d8g2UCb/images/image-3.png?fit=max&auto=format&n=QElh_CM21d8g2UCb&q=85&s=827a2c5aa9c9e57806a6312d27500084" alt="Image" width="1576" height="589" data-path="images/image-3.png" />
</Frame>

Select **app type as SWA**.

<Frame>
  <img src="https://mintcdn.com/ifax/nnhma-qhidEQa112/images/image-4.png?fit=max&auto=format&n=nnhma-qhidEQa112&q=85&s=e9871970adeb52371b89a05b22fc99b7" alt="Image" width="1593" height="708" data-path="images/image-4.png" />
</Frame>

Provide details for **General Settings**:

**App Name:** Your app name\
**App's login page URL:** [https://ifaxapp.com/login/](https://ifaxapp.com/login/)

<Frame>
  <img src="https://mintcdn.com/ifax/nnhma-qhidEQa112/images/image-5.png?fit=max&auto=format&n=nnhma-qhidEQa112&q=85&s=369b77659f4a9df208d7377321beed65" alt="Image" width="1599" height="681" data-path="images/image-5.png" />
</Frame>

Once the app is saved, you need to change the **app type to SCIM**.

***

## Setup Provisioning

You can set up provisioning for the app with the following steps:

Go to **Provisioning > Integration** and click **Edit**.

### Manage SCIM Connection

**SCIM connector base URL:** [https://www.ifaxapp.com/live/Oktawebhook/index\\\\](https://www.ifaxapp.com/live/Oktawebhook/index\\\\) **Unique identifier field for users:** userName\
**Supported provisioning actions:**

<Frame>
  <img src="https://mintcdn.com/ifax/nnhma-qhidEQa112/images/image-6.png?fit=max&auto=format&n=nnhma-qhidEQa112&q=85&s=27b3900b93f567bf0e2cfab36bceff8f" alt="Image" width="1581" height="681" data-path="images/image-6.png" />
</Frame>

\
Import New Users and Profile Updates, Push New Users, Push Profile Updates

Select **Authentication Mode:** Basic Auth

You need to add **Amplify credentials**.

**Username:** Amplify Email\
**Password:** Amplify Password

<Frame>
  <img src="https://mintcdn.com/ifax/nnhma-qhidEQa112/images/image-7.png?fit=max&auto=format&n=nnhma-qhidEQa112&q=85&s=dcc09a3071ef4d7908d71247edab3654" alt="Image" width="1581" height="670" data-path="images/image-7.png" />
</Frame>

Be sure to test the connector configuration before saving.

Go to **Provisioning > To App**

Enable the following **Provisioning to App** options:

Create Users\
Update User Attributes\
Deactivate Users

<Frame>
  <img src="https://mintcdn.com/ifax/nnhma-qhidEQa112/images/image-8.png?fit=max&auto=format&n=nnhma-qhidEQa112&q=85&s=ec2f40f2ef996660150b596adef168ce" alt="Image" width="1578" height="676" data-path="images/image-8.png" />
</Frame>

***

## Add Attribute for Permission

To add a custom attribute for permission, follow these steps:

Go to **Profile Editor**

Search for your app.

<Frame>
  <img src="https://mintcdn.com/ifax/nnhma-qhidEQa112/images/image-9.png?fit=max&auto=format&n=nnhma-qhidEQa112&q=85&s=f200833e6131e04058174a6be325e853" alt="Image" width="1578" height="600" data-path="images/image-9.png" />
</Frame>

Go to **Attributes** and add a **New Attribute**.

<Frame>
  <img src="https://mintcdn.com/ifax/QElh_CM21d8g2UCb/images/image-10.png?fit=max&auto=format&n=QElh_CM21d8g2UCb&q=85&s=23b2a8b9785858c7b9f7a71032820ef1" alt="Image" width="1580" height="652" data-path="images/image-10.png" />
</Frame>

For **Custom Attributes**, set the following parameters:

**Data Type:** String\
**Display Name:** User Permission\
**Variable Name:** userPermission\
**External Name:** userPermission\
**External Namespace:** urn:ietf:params:scim:schemas:core:2.0:User

<Frame>
  <img src="https://mintcdn.com/ifax/QElh_CM21d8g2UCb/images/image-11.png?fit=max&auto=format&n=QElh_CM21d8g2UCb&q=85&s=190acf6b19bef2556e7dfa7a3155a443" alt="Image" width="862" height="707" data-path="images/image-11.png" />
</Frame>

Here you can see the attribute added.

<Frame>
  <img src="https://mintcdn.com/ifax/QElh_CM21d8g2UCb/images/image-12.png?fit=max&auto=format&n=QElh_CM21d8g2UCb&q=85&s=b5aeb62d179b2d089e8b1261d70ad189" alt="Image" width="1582" height="583" data-path="images/image-12.png" />
</Frame>

***

## Assign Or Delete User

To add a user, follow these steps:

Go to **People > Add Person**

<Frame>
  <img src="https://mintcdn.com/ifax/QElh_CM21d8g2UCb/images/image-13.png?fit=max&auto=format&n=QElh_CM21d8g2UCb&q=85&s=f67f3ac30a9edfee6228b707b05076d4" alt="Image" width="1572" height="603" data-path="images/image-13.png" />
</Frame>

Go to **Application > Assign > Assign People**

<Frame>
  <img src="https://mintcdn.com/ifax/QElh_CM21d8g2UCb/images/image-14.png?fit=max&auto=format&n=QElh_CM21d8g2UCb&q=85&s=303241f59ba8470b1365bc14d1308277" alt="Image" width="1578" height="668" data-path="images/image-14.png" />
</Frame>

Select **People to assign the App**

<Frame>
  <img src="https://mintcdn.com/ifax/QElh_CM21d8g2UCb/images/image-15.png?fit=max&auto=format&n=QElh_CM21d8g2UCb&q=85&s=a129e2dc4df17ae7d8bc2a7e707eca01" alt="Image" width="846" height="722" data-path="images/image-15.png" />
</Frame>

Add the custom permission in **User Permission**. This will be a **group name**, and that group name should exist in iFax.

<Frame>
  <img src="https://mintcdn.com/ifax/QElh_CM21d8g2UCb/images/image-16.png?fit=max&auto=format&n=QElh_CM21d8g2UCb&q=85&s=319e9e6cf0a46c3fa70c3e1e982b3625" alt="Image" width="829" height="722" data-path="images/image-16.png" />
</Frame>

\
All permissions will be assigned to the user based on this group.

***

## To Delete User

To delete a user, follow these steps:

Go to **Application > People**

Delete the specific user from here.
