Adding the Fotoware application to the Azure portal

1. Log in to the Azure portal and open Microsoft Entra ID.
2. Select Add > App 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 Microsoft Entra ID 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.
   When using group-based access control, you must add access to the directory as the signed-in user (Directory.AccessAsUser.All). This is not necessary if you are only using role-based access control. 

3. Select Save to update the permissions.

Creating the application secret

1. Open the Certificates & secrets view for your application. You can 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. Then, copy it to the clipboard and paste it into the Application key field in the Microsoft Entra ID settings in the Operations Center.

Note: It is the customer's responsibility to replace the application key before it expires. Because the validity of application keys varies, it's practical to set a reminder in your maintenance calendar to replace the key before it expires. If the key does expire, users will temporarily lose access to the system. 

Adding Microsoft Entra ID information to the Fotoware Site Configuration

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

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

Application Key - The secret generated in the Azure portal.

Authority -This is the URL of the Microsoft Entra ID authentication service. Typically, it is https://login.microsoftonline.com (the global Microsoft Entra ID 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, which is used to retrieve 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), andDirectory ID values and save the changes.
   

Groups and access control for Microsoft Entra ID

Next, you need to import groups from Microsoft Entra ID to give them access to Fotoware. You can then assign access to Fotoware archives and actions using the imported groups.