Skip to content

Commit b86bcbf

Browse files
authored
Merge pull request #210515 from v-missam/apple
doc-1
2 parents f6ae2a0 + 0f0e72d commit b86bcbf

File tree

7 files changed

+45
-31
lines changed

7 files changed

+45
-31
lines changed

articles/active-directory/saas-apps/apple-business-manager-provision-tutorial.md

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ This tutorial describes the steps you need to perform in both Apple Business Man
2929
> * Create users in Apple Business Manager
3030
> * Remove users in Apple Business Manager when they do not require access anymore
3131
> * Keep user attributes synchronized between Azure AD and Apple Business Manager
32+
> * [Single sign-on](../manage-apps/add-application-portal-setup-oidc-sso.md) to Apple Business Manager (recommended).
3233
3334
## Prerequisites
3435

@@ -52,17 +53,21 @@ The scenario outlined in this tutorial assumes that you already have the followi
5253
2. Click Settings at the bottom of the sidebar click Data Source below Organization Settings, then click Connect to Data Source.
5354
3. Click Connect next to SCIM, carefully read the warning, click Copy, then click Close.
5455
[The Connect to SCIM window, which provides a token and a Copy button under it.]
55-
Leave this window open to copy the Tenant URL from Apple Business Manager to Azure AD, which is: 'https://federation.apple.com/feeds/business/scim'
56+
Leave this window open to copy the Tenant URL from Apple Business Manager to Azure AD, which is: `https://federation.apple.com/feeds/business/scim`
5657

57-
![Apple Business Manager](media/applebusinessmanager-provisioning-tutorial/scim-token.png)
58+
![Screenshot of Apple Business Manager token generation.](media/apple-business-manager-provision-tutorial/scim-token.png)
5859

59-
> [!NOTE]
60-
> The secret token shouldn’t be shared with anyone other than the Azure AD administrator.
60+
> [!NOTE]
61+
> The secret token shouldn’t be shared with anyone other than the Azure AD administrator.
6162
6263
## Step 3. Add Apple Business Manager from the Azure AD application gallery
6364

64-
Add Apple Business Manager from the Azure AD application gallery to start managing provisioning to Apple Business Manager. If you have previously setup Apple Business Manager for SSO, you can use the same application. However it is recommended that you create a separate app when testing out the integration initially. Learn more about adding an application from the gallery [here](../manage-apps/add-application-portal.md).
65+
* Add Apple Business Manager from the Azure AD application gallery to start managing provisioning to Apple Business Manager. If you have previously setup Apple Business Manager for SSO, you can use the same application. However it is recommended that you create a separate app when testing out the integration initially.
66+
67+
* To add the Apple Business Manager Azure AD app with Microsoft tenants, the administrator of the tenants must go through the federated authentication setup process, including testing authentication. When authentication has succeeded, the Apple Business Manager Azure AD app is populated in the tenant and the administrator can federate domains and configure Apple Business Manager to use SCIM (System for Cross-domain Identity Management) for directory sync.
6568

69+
[Use federated authentication with MS Azure AD in Apple Business Manager](https://support.apple.com/en-ke/guide/apple-business-manager/axmb02f73f18/web)
70+
6671
## Step 4. Define who will be in scope for provisioning
6772

6873
The Azure AD provisioning service allows you to scope who will be provisioned based on assignment to the application and or based on attributes of the user / group. If you choose to scope who will be provisioned to your app based on assignment, you can use the following [steps](../manage-apps/assign-user-or-group-access-portal.md) to assign users and groups to the application. If you choose to scope who will be provisioned based solely on attributes of the user or group, you can use a scoping filter as described [here](../app-provisioning/define-conditional-rules-for-provisioning-user-accounts.md).
@@ -75,30 +80,30 @@ The Azure AD provisioning service allows you to scope who will be provisioned ba
7580

7681
1. Sign in to the [Azure portal](https://portal.azure.com). Select **Enterprise Applications**, then select **All applications**.
7782

78-
![Enterprise applications blade](common/enterprise-applications.png)
83+
![Screenshot of Enterprise applications blade.](common/enterprise-applications.png)
7984

8085
2. In the applications list, select **Apple Business Manager**.
8186

82-
![The Apple Business Manager in the Applications list](common/all-applications.png)
87+
![Screenshot of the Apple Business Manager in the Applications list.](common/all-applications.png)
8388

8489
3. Select the **Provisioning** tab.
8590

86-
![Provisioning tab](common/provisioning.png)
91+
![Screenshot of Provisioning tab.](common/provisioning.png)
8792

8893
4. Set the **Provisioning Mode** to **Automatic**.
8994

90-
![Provisioning tab automatic](common/provisioning-automatic.png)
95+
![Screenshot of Provisioning tab automatic.](common/provisioning-automatic.png)
9196

92-
5. Under the **Admin Credentials** section, input the **SCIM 2.0 base URL and Access Token** values retrieved from Apple Business Manager in **Tenant URL** and **Secret Token** respectively.. Click **Test Connection** to ensure Azure AD can connect to Apple Business Manager. If the connection fails, ensure your Apple Business Manager account has Admin permissions and try again.
97+
5. Under the **Admin Credentials** section, input the **SCIM 2.0 base URL and Access Token** values retrieved from Apple Business Manager in **Tenant URL** and **Secret Token** respectively. Click **Test Connection** to ensure Azure AD can connect to Apple Business Manager. If the connection fails, ensure your Apple Business Manager account has Admin permissions and try again.
9398

94-
![Token](common/provisioning-testconnection-tenanturltoken.png)
99+
![Screenshot of Token.](common/provisioning-testconnection-tenanturltoken.png)
95100

96101
> [!NOTE]
97102
>If the connection is successful, Apple Business Manager shows the SCIM connection as active. This process can take up to 60 seconds for Apple Business Manager to reflect the latest connection status.
98103
99104
6. In the **Notification Email** field, enter the email address of a person or group who should receive the provisioning error notifications and check the checkbox - **Send an email notification when a failure occurs**.
100105

101-
![Notification Email](common/provisioning-notification-email.png)
106+
![Screenshot of Notification Email.](common/provisioning-notification-email.png)
102107

103108
7. Click **Save**.
104109

@@ -125,15 +130,15 @@ The Azure AD provisioning service allows you to scope who will be provisioned ba
125130

126131
11. To enable the Azure AD provisioning service for Apple Business Manager, change the **Provisioning Status** to **On** in the Settings section.
127132

128-
![Provisioning Status Toggled On](common/provisioning-toggle-on.png)
133+
![Screenshot of Provisioning Status Toggled On.](common/provisioning-toggle-on.png)
129134

130135
12. Define the users and/or groups that you would like to provision to Apple Business Manager by choosing the desired values in **Scope** in the **Settings** section.
131136

132-
![Provisioning Scope](common/provisioning-scope.png)
137+
![Screenshot of Provisioning Scope.](common/provisioning-scope.png)
133138

134139
13. When you are ready to provision, click **Save**.
135140

136-
![Saving Provisioning Configuration](common/provisioning-configuration-save.png)
141+
![Screenshot of Saving Provisioning Configuration.](common/provisioning-configuration-save.png)
137142

138143
This operation starts the initial synchronization of all users and/or groups defined in **Scope** in the **Settings** section. The initial sync takes longer to perform than subsequent syncs, which occur approximately every 40 minutes as long as the Azure AD provisioning service is running.
139144

articles/active-directory/saas-apps/apple-school-manager-provision-tutorial.md

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ This tutorial describes the steps you need to perform in both Apple School Manag
2929
> * Create users in Apple School Manager
3030
> * Remove users in Apple School Manager when they do not require access anymore
3131
> * Keep specific user attributes synchronized between Azure AD and Apple School Manager
32+
> * [Single sign-on](../manage-apps/add-application-portal-setup-oidc-sso.md) to Apple School Manager (recommended).
3233
3334
## Prerequisites
3435

@@ -52,17 +53,21 @@ The scenario outlined in this tutorial assumes that you already have the followi
5253
2. Click Settings at the bottom of the sidebar click Data Source below Organization Settings, then click Connect to Data Source.
5354
3. Click Connect next to SCIM, carefully read the warning, click Copy, then click Close.
5455
[The Connect to SCIM window, which provides a token and a Copy button under it.]
55-
Leave this window open to copy the Tenant URL from Apple Business Manager to Azure AD, which is: 'https://federation.apple.com/feeds/school/scim'
56+
Leave this window open to copy the Tenant URL from Apple School Manager to Azure AD, which is: `https://federation.apple.com/feeds/school/scim`
5657

57-
![Apple School Manager](media/appleschoolmanager-provisioning-tutorial/scim-token.png)
58+
![Screenshot of Apple School Manager token generation.](media/apple-school-manager-provision-tutorial/scim-token.png)
5859

59-
> [!NOTE]
60-
> The secret token shouldn’t be shared with anyone other than the Azure AD administrator.
60+
> [!NOTE]
61+
> The secret token shouldn’t be shared with anyone other than the Azure AD administrator.
6162

6263
## Step 3. Add Apple School Manager from the Azure AD application gallery
6364

64-
Add Apple School Manager from the Azure AD application gallery to start managing provisioning to Apple School Manager. If you have previously setup Apple School Manager for SSO, you can use the same application. However it is recommended that you create a separate app when testing out the integration initially. Learn more about adding an application from the gallery [here](../manage-apps/add-application-portal.md).
65+
* Add Apple School Manager from the Azure AD application gallery to start managing provisioning to Apple School Manager. If you have previously setup Apple School Manager for SSO, you can use the same application. However it is recommended that you create a separate app when testing out the integration initially.
66+
67+
* To add the Apple School Manager Azure AD app with Microsoft tenants, the administrator of the tenants must go through the federated authentication setup process, including testing authentication. When authentication has succeeded, the Apple School Manager Azure AD app is populated in the tenant and the administrator can federate domains and configure Apple School Manager to use SCIM (System for Cross-domain Identity Management) for directory sync.
6568

69+
[Use federated authentication with MS Azure AD in Apple School Manager](https://support.apple.com/en-ke/guide/apple-school-manager/axmb02f73f18/web)
70+
6671
## Step 4. Define who will be in scope for provisioning
6772

6873
The Azure AD provisioning service allows you to scope who will be provisioned based on assignment to the application and or based on attributes of the user / group. If you choose to scope who will be provisioned to your app based on assignment, you can use the following [steps](../manage-apps/assign-user-or-group-access-portal.md) to assign users and groups to the application. If you choose to scope who will be provisioned based solely on attributes of the user or group, you can use a scoping filter as described [here](../app-provisioning/define-conditional-rules-for-provisioning-user-accounts.md).
@@ -75,30 +80,30 @@ The Azure AD provisioning service allows you to scope who will be provisioned ba
7580

7681
1. Sign in to the [Azure portal](https://portal.azure.com). Select **Enterprise Applications**, then select **All applications**.
7782

78-
![Enterprise applications blade](common/enterprise-applications.png)
83+
![Screenshot of Enterprise applications blade.](common/enterprise-applications.png)
7984

8085
2. In the applications list, select **Apple School Manager**.
8186

82-
![The Apple School Manager in the Applications list](common/all-applications.png)
87+
![Screenshot of Apple School Manager in the Applications list.](common/all-applications.png)
8388

8489
3. Select the **Provisioning** tab.
8590

86-
![Provisioning tab](common/provisioning.png)
91+
![Screenshot of Provisioning tab.](common/provisioning.png)
8792

8893
4. Set the **Provisioning Mode** to **Automatic**.
8994

90-
![Provisioning tab automatic](common/provisioning-automatic.png)
95+
![Screenshot of Provisioning tab automatic.](common/provisioning-automatic.png)
9196

92-
5. Under the **Admin Credentials** section, input the **SCIM 2.0 base URL and Access Token** values retrieved from Apple School Manager in **Tenant URL** and **Secret Token** respectively.. Click **Test Connection** to ensure Azure AD can connect to Apple School Manager. If the connection fails, ensure your Apple School Manager account has Admin permissions and try again.
97+
5. Under the **Admin Credentials** section, input the **SCIM 2.0 base URL and Access Token** values retrieved from Apple School Manager in **Tenant URL** and **Secret Token** respectively. Click **Test Connection** to ensure Azure AD can connect to Apple School Manager. If the connection fails, ensure your Apple School Manager account has Admin permissions and try again.
9398

94-
![Token](common/provisioning-testconnection-tenanturltoken.png)
99+
![Screenshot of Token.](common/provisioning-testconnection-tenanturltoken.png)
95100

96101
> [!NOTE]
97102
>If the connection is successful, Apple School Manager shows the SCIM connection as active. This process can take up to 60 seconds for Apple School Manager to reflect the latest connection status.
98103
99104
6. In the **Notification Email** field, enter the email address of a person or group who should receive the provisioning error notifications and check the checkbox - **Send an email notification when a failure occurs**.
100105

101-
![Notification Email](common/provisioning-notification-email.png)
106+
![Screenshot of Notification Email.](common/provisioning-notification-email.png)
102107

103108
7. Click **Save**.
104109

@@ -125,15 +130,15 @@ The Azure AD provisioning service allows you to scope who will be provisioned ba
125130

126131
11. To enable the Azure AD provisioning service for Apple School Manager, change the **Provisioning Status** to **On** in the Settings section.
127132

128-
![Provisioning Status Toggled On](common/provisioning-toggle-on.png)
133+
![Screenshot of Provisioning Status Toggled On.](common/provisioning-toggle-on.png)
129134

130135
12. Define the users and/or groups that you would like to provision to Apple School Manager by choosing the desired values in **Scope** in the **Settings** section.
131136

132-
![Provisioning Scope](common/provisioning-scope.png)
137+
![Screenshot of Provisioning Scope.](common/provisioning-scope.png)
133138

134139
13. When you are ready to provision, click **Save**.
135140

136-
![Saving Provisioning Configuration](common/provisioning-configuration-save.png)
141+
![Screenshot of Saving Provisioning Configuration.](common/provisioning-configuration-save.png)
137142

138143
This operation starts the initial synchronization of all users and/or groups defined in **Scope** in the **Settings** section. The initial sync takes longer to perform than subsequent syncs, which occur approximately every 40 minutes as long as the Azure AD provisioning service is running.
139144

51.7 KB
Loading
51.7 KB
Loading

articles/active-directory/saas-apps/toc.yml

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2695,7 +2695,11 @@
26952695
- name: Amazon Web Services (AWS) - Role Provisioning
26962696
href: amazon-web-service-tutorial.md#configure-azure-ad-sso
26972697
- name: Appaegis Isolation Access Cloud
2698-
href: appaegis-isolation-access-cloud-provisioning-tutorial.md
2698+
href: appaegis-isolation-access-cloud-provisioning-tutorial.md
2699+
- name: Apple School Manager
2700+
href: apple-school-manager-provision-tutorial.md
2701+
- name: Apple Business Manager
2702+
href: apple-business-manager-provision-tutorial.md
26992703
- name: Asana
27002704
href: asana-provisioning-tutorial.md
27012705
- name: askSpoke

0 commit comments

Comments
 (0)