Skip to content

Commit 757fa97

Browse files
committed
update managed identities articles
1 parent 2a51546 commit 757fa97

File tree

2 files changed

+17
-9
lines changed

2 files changed

+17
-9
lines changed

articles/applied-ai-services/form-recognizer/managed-identities.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,13 @@ ms.author: lajanuar
1212
ms.custom: ignite-fall-2021
1313
---
1414

15-
# Create and use managed identities
15+
# Managed identities for Form Recognizer
1616

1717
Managed identities for Azure resources are service principals that create an Azure Active Directory (Azure AD) identity and specific permissions for Azure managed resources:
1818

19-
* You can use managed identities **instead of a shared access signature (SAS) token** to grant access to any resource that supports Azure AD authentication.
19+
* You can use managed identities to grant access to any resource that supports Azure AD authentication, including your own applications. Unlike security keys and authentication tokens, managed identities eliminate the need for developers to manage credentials.
2020

21-
* To grant access, assign a role to a managed identity using [Azure role-based access control (Azure RBAC)](../../role-based-access-control/overview.md).
21+
* To grant access to an Azure resource, assign an Azure role to a managed identity using [Azure role-based access control (Azure RBAC)](../../../role-based-access-control/overview.md).
2222

2323
* There's no added cost to use managed identities in Azure.
2424

@@ -119,7 +119,7 @@ You need to grant Form Recognizer access to your storage account before it can c
119119

120120
:::image type="content" source="media/managed-identities/assigned-roles-window.png" alt-text="Screenshot: Azure role assignments window.":::
121121

122-
That's it! You've completed the steps to enable a system-assigned managed identity. With managed identity and Azure RBAC, you granted Form Recognizer specific access rights to documents and files stored in your storage resource without having to manage credentials, such as SAS tokens.
122+
That's it! You've completed the steps to enable a system-assigned managed identity. With managed identity and Azure RBAC, you granted Form Recognizer specific access rights to your storage resource without having to manage credentials such as SAS tokens.
123123

124124
## Learn more about managed identity
125125

articles/cognitive-services/Translator/document-translation/managed-identity.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Create and use managed identities
2+
title: Create and use managed identities for Document Translation
33
titleSuffix: Azure Cognitive Services
44
description: Understand how to create and use managed identities in the Azure portal
55
author: laujan
@@ -11,15 +11,17 @@ ms.date: 02/22/2022
1111
ms.author: lajanuar
1212
---
1313

14-
# Create and use managed identities
14+
# Managed identities for Document Translation
1515

1616
> [!IMPORTANT]
1717
>
1818
> Managed identities for Azure resources are currently unavailable for Document Translation service in the global region. If you intend to use managed identities for Document Translation operations, [create your Translator resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) in a non-global Azure region.
1919
2020
Managed identities for Azure resources are service principals that create an Azure Active Directory (Azure AD) identity and specific permissions for Azure managed resources:
2121

22-
* You can use managed identities **instead of a shared access signature (SAS) token** to grant access to any resource that supports Azure AD authentication, including your own applications. To grant access, assign a role to a managed identity using [Azure role-based access control (Azure RBAC)](../../../role-based-access-control/overview.md).
22+
* You can use managed identities to grant access to any resource that supports Azure AD authentication, including your own applications. Unlike security keys and authentication tokens, managed identities eliminate the need for developers to manage credentials.
23+
24+
* To grant access to an Azure resource, assign an Azure role to a managed identity using [Azure role-based access control (Azure RBAC)](../../../role-based-access-control/overview.md).
2325

2426
* There's no added cost to use managed identities in Azure.
2527

@@ -52,7 +54,11 @@ To get started, you'll need:
5254

5355
## Managed identity assignments
5456

55-
There are two types of managed identities: **system-assigned** and **user-assigned**. Currently, Document Translation is supported by system-assigned managed identities. A system-assigned managed identity is **enabled** directly on a service instance. It isn't enabled by default; you must go to your resource and update the identity setting. The system-assigned managed identity is tied to your resource throughout its lifecycle. If you delete your resource, the managed identity will be deleted as well.
57+
There are two types of managed identities: **system-assigned** and **user-assigned**. Currently, Document Translation is supports system-assigned managed identities:
58+
59+
* A system-assigned managed identity is **enabled** directly on a service instance. It isn't enabled by default; you must go to your resource and update the identity setting.
60+
61+
* The system-assigned managed identity is tied to your resource throughout its lifecycle. If you delete your resource, the managed identity will be deleted as well.
5662

5763
In the following steps, we'll enable a system-assigned managed identity and grant your Translator resource limited access to your Azure blob storage account.
5864

@@ -74,7 +80,9 @@ In the following steps, we'll enable a system-assigned managed identity and gran
7480

7581
## Grant access to your storage account
7682

77-
You need to grant Translator access to your storage account before it can create, read, or delete blobs. Now that you enabled Translator with a system-assigned managed identity, you can use Azure role-based access control (Azure RBAC), to give a managed identity (Translator) access to another resource (Azure storage), just like any security principal. The **Storage Blob Data Contributor** role gives Translator (represented by the system-assigned managed identity) read, write, and delete access to the blob container and data.
83+
You need to grant Translator access to your storage account before it can create, read, or delete blobs. Now that you enabled Translator with a system-assigned managed identity, you can use Azure role-based access control (Azure RBAC), to give Translator access to Azure storage.
84+
85+
The **Storage Blob Data Contributor** role gives Translator (represented by the system-assigned managed identity) read, write, and delete access to the blob container and data.
7886

7987
1. Under **Permissions** select **Azure role assignments**:
8088

0 commit comments

Comments
 (0)