> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Se connecter à un partage de fichiers Microsoft Azure
> Connectez le serveur d’applications ABBYY FlexiCapture à un partage Microsoft Azure Files, stockez les identifiants dans le Gestionnaire d’identifiants et configurez le pool d’applications IIS.
Vous pouvez connecter le serveur d’applications ABBYY FlexiCapture à un partage de fichiers dans Microsoft Azure.
Cet article suppose qu’un compte de stockage a déjà été créé dans Microsoft Azure Files et qu’il est disponible pour ABBYY FlexiCapture.
1. Dans le portail Azure, accédez à votre compte de stockage (`abbyystorage` dans cet exemple) et cliquez sur **Files** dans le volet du compte de stockage.
2. Créez un nouveau partage de fichiers dans votre compte de stockage en spécifiant son nom (`fcstorage` dans cet exemple) et, si nécessaire, un quota d’espace.
3. Ouvrez le partage de fichiers créé et cliquez sur **Connect**.
4. Copiez la commande `cmdkey` dans le Clipboard.
5. Connectez-vous à la machine virtuelle hébergeant le serveur d’applications FlexiCapture en tant qu’utilisateur système disposant des autorisations nécessaires pour accéder aux services FlexiCapture (`fcuser` dans cet exemple), ouvrez l’invite de commande, puis collez et exécutez la commande `cmdkey` depuis le Clipboard. Cela ajoutera les identifiants du partage de fichiers au Gestionnaire d’identifiants Windows.
6. Ouvrez l’Explorateur Windows et assurez-vous que l’utilisateur peut accéder au partage de fichiers.
7. Ouvrez le Gestionnaire des services Internet (IIS), sélectionnez le pool d’applications FlexiCapture et cliquez sur **Advanced Settings**.
8. Modifiez l’identité du pool afin d’utiliser le compte d’utilisateur FlexiCapture doté des autorisations requises, définissez **Load User Profile** sur **True**, confirmez les modifications en cliquant sur **OK**, puis recyclez le pool d’applications.
9. Dans l’Administration and Monitoring Console, sélectionnez l’option **stockage de fichiers externe** et spécifiez le chemin d’accès vers le partage de fichiers dans Microsoft Azure.
## Utiliser Azure Key Vault pour se connecter à Microsoft Azure Files
Azure Key Vault est un service cloud qui permet de stocker en toute sécurité des secrets, tels que des clés d’API, des mots de passe et des certificats. Ce service permet aux abonnés Azure de protéger les données sensibles utilisées par leurs applications et services cloud. Vous pouvez créer et gérer des coffres de clés via le portail Azure (consultez la [documentation Microsoft](https://docs.microsoft.com/en-us/azure/key-vault/general/basic-concepts) pour plus de détails).
Pour configurer une connexion à Azure Files :
### Dans le portail Azure
1. Configurez des machines virtuelles pour vos serveurs d’applications ABBYY FlexiCapture.
**Important !** Les machines virtuelles sur lesquelles le serveur d’applications est installé doivent être enregistrées dans Azure Active Directory. Pour obtenir des instructions détaillées sur la création et la configuration de machines virtuelles, consultez la [documentation Microsoft](https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vm#system-assigned-managed-identity).
2. Créez un nouveau coffre de clés. Sous **Permission model**, sélectionnez **Azure role-based access control**.
3. Pour pouvoir enregistrer et consulter des secrets, ajoutez le rôle **Key Vault Secrets Officer** à votre compte et le rôle **Key Vault Secrets User** aux objets des machines virtuelles. Pour obtenir des instructions détaillées sur l’octroi d’autorisations aux machines virtuelles, consultez la [documentation Microsoft](https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/tutorial-windows-vm-access-arm).
4. Ajoutez à votre coffre de clés votre secret (c’est-à-dire votre clé d’accès) pour votre compte de stockage Azure. Pour obtenir des instructions détaillées sur l’ajout d’un secret à un coffre de clés, consultez la [documentation Microsoft](https://docs.microsoft.com/en-us/azure/key-vault/secrets/quick-create-portal#add-a-secret-to-key-vault).
**Important !** Pour vous connecter à Azure Files, le nom de votre secret doit être identique au nom de votre compte de stockage.
### Sur chaque serveur d’applications
Configurez votre compte système pour accéder à Azure Files. Pour ce faire :
1. Enregistrez le script PowerShell suivant sur chaque machine virtuelle où le serveur d’applications est installé :
```powershell theme={null}
Param(
[Parameter(Mandatory=$true)][Alias("Share")][ValidateNotNullOrEmpty()][String]$ShareRoot,
[Parameter(Mandatory=$true)][Alias("Uri")][ValidateNotNullOrEmpty()][String]$VaultUri
)
$StorageAccount = $ShareRoot | Select-String -pattern "(?<=\\)(.*?)(?=(\\|[.]))" | Select-Object -ExpandProperty Matches | Select-Object -ExpandProperty Value
$ShareUser = "Azure\" + $StorageAccount
# Récupérer les paramètres depuis Azure Key Vault
$Response = Invoke-RestMethod -UseBasicParsing -Uri 'https://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01&resource=https%3A%2F%2Fvault.azure.net' -Method GET -Headers @{Metadata="true"}
$BearerToken = $Response.access_token
# SharePass
$Uri = ($VaultUri).TrimEnd('/') + "/secrets/" + $StorageAccount + "?api-version=2016-10-01"
$Response = Invoke-RestMethod -UseBasicParsing -Uri $Uri -Method GET -Headers @{Authorization="Bearer $BearerToken"}
$SharePass = $Response.value
$ShareCredential = New-Object PSCredential($ShareUser, (ConvertTo-SecureString -AsPlainText -Force -String $SharePass))
New-PSDrive -Name "Flexicapture" -PSProvider FileSystem -Root $ShareRoot -Credential $ShareCredential -Scope Global
```
Le script accepte les deux paramètres suivants en entrée :
* Le chemin d’accès à la racine du dossier réseau Azure, par exemple : `\\.file.core.windows.net\`.
* L’URI du Key Vault qui stocke la clé d’accès de votre Azure Storage account. Vous pouvez copier l’URI depuis le champ **Vault URI** de l’onglet **Vue d’ensemble** du portail Azure.
Exemple de commande pour exécuter le script :
```powershell theme={null}
powershell.exe -share \\.file.core.windows.net\ -uri https://.vault.azure.net/
```
2. Pour exécuter le script, créez une tâche dans le Planificateur de tâches qui se déclenche au démarrage du système. La tâche doit être exécutée sous le compte d’utilisateur System, Network Service ou Local Service. Le même compte doit être utilisé pour exécuter le pool d’applications IIS.
3. Configurez le service IIS pour qu’il démarre après l’exécution du script de connexion. Pour ce faire, ouvrez la boîte de dialogue **World Wide Web Publishing Service Properties**, puis sélectionnez **Automatic (Delayed Start)** dans la liste déroulante **Startup type** de l’onglet **General**.
4. Redémarrez le serveur d’applications.