Setting up SSO with Azure AD

Adding the FotoWare application to the Azure management console

1. Log in to the Azure portal and open Azure Active Directory.
2. Select Add application registration. 

3. Enter a name for the application. 
4. Select Web from the Select a platform drop-down list. 
5. Select the Redirect URI that your application uses. For single sign-on to a FotoWare site, the URL must have the following format: 

https://<site hostname>/fotoweb/auth/signin-oidc

  Example: https://contoso.fotoware.cloud/fotoweb/auth/signin-oidc

 Alternatively, you can copy the URI (https://internalpreview.fotoware.cloud/fotoweb/auth/signin-oidc) from the Single Sign-on settings for the site. (Go to Site Configuration > Security > Single Sign-on).

6. Select Register.

Tip: After creating the application registration, open the Overview section for your newly registered application to retrieve the Application ID (see the example below). You need this ID for the FotoWare Azure AD configuration in the site configuration later.

Note: If you previously enabled implicit grant for ID tokens (in the Authentication section) for FotoWare 8.0, we recommend that you disable this option for FotoWare 8.1. 

Assigning permissions to the application

1. Open the API permissions view for your application and select Add a permission.

2. Use Microsoft Graph and add the User.Read Delegated permission:

3. Select Save to update the permissions.

Creating the application secret

1. Open the Certificates & secrets view for your application. You find this in the same menu as API permissions above or as a link in the Overview section.
2. Select New client secret. 
3. Enter a description (simply a label) in the Description field. 
4. Select a duration from the Expires drop-down list. For security reasons, a key can be valid for a maximum of two years.
5. Select Add to create the client secret.  You can then copy it to the clipboard and paste it into the Application key field in the Azure AD settings in the Operations Center.

Note: Application keys must be renewed before they expire, otherwise users will temporarily lose access to the system. Each customer has the responsibility to avoid this situation. We recommend setting reminders and designating responsibility so that there is always someone available to renew the application keys when necessary. 

Adding Azure AD information to the FotoWare Site Configuration

Make sure you have the necessary information from the Azure console before proceeding:

Application Id - You can find this in the Overview section.

Application Key - The secret generated in the Azure console.

Authority - This is the URL of the Azure AD authentication service. Typically, it is https://login.microsoftonline.com (the global Azure AD service), but this can be different when using different authentication providers.

Directory ID - You can find the Directory ID in the Overview section, next to the Application ID.

Microsoft Graph Authority - This is the base URL for Microsoft Graph, used for retrieving user and group information.

Adding the information to the FotoWare tenant in FotoWeb Settings

1. In the FotoWeb Settings app, open Sites. 
2. Select Configuration for the site in question.
3. Go to Security > Single Sign-on.
4. Turn on the Enable Single Sign-on toggle.
5. Enter the Application ID, Application Key (called Client Secret in the Azure portal), and Directory Id values and save the changes.

Groups and access control for Azure 

Next, you need to import groups from the Azure AD to give them access to FotoWare. You can then proceed to assign access to FotoWare archives and actions using the imported groups.