Utilisation d'Active Directory comme source d'authentification (Federation)
Découvrez comment utiliser votre serveur Active Directory comme source d'authentification pour vos utilisateurs vSphere
Dernière mise à jour le 10/02/2022
Objectif
Ce guide a pour objectif d'expliquer les détails de la mise en place d'un serveur Active Directory comme source d'authentification sur l'offre Hosted Private Cloud OVHcloud.
Découvrez comment utiliser votre serveur Active Directory comme source d'authentification pour vos utilisateurs vSphere.
Prérequis
- Avoir souscrit une offre Hosted Private Cloud.
- Disposer d'un serveur Active Directory acessible depuis une adresse IP publique et possédant un certificat SSL valide pour le service LDAPS.
- Disposer d'un accès utilisateur au domaine Active Directory associé, avec au minimum un accès en lecture seule (pour la connexion LDAPS).
- Avoir accès à l’interface de gestion vSphere de votre Hosted Private Cloud.
En pratique
Récupérer les informations nécessaires
La connexion du vCenter au serveur Active Directory est réalisée via le protocole LDAPS fourni par le serveur Active Directory.
Afin de préparer la mise en place de la configuration, vous devez récupèrer les informations suivantes :
- Nom de domaine Active Directory (FQDN).
- Alias de domaine Active Directory (Nom NetBIOS).
- Adresse IP publique du serveur Active Directory.
- Nom d'hôte du serveur LDAPS Active Directory. Nom utilisé dans le certificat SSL du service LDAPS, ce nom doit résoudre sur l'adresse IP publique du serveur Active Directory.
- Port du service LDAPS (par défaut 636).
- Base DN (Base Distinguished Name) pour les utilisateurs. Il s'agit du DN à partir duquel seront recherchés les utilisateurs. Par exemple, cn=Users,dc=example,dc=com
- Base DN (Base Distinguished Name) pour les groupes. Il s'agit du DN à partir duquel seront recherchés les groupes. Par exemple, cn=Groups,dc=example,dc=com
- Identifiant et mot de passe d'un utilisateur du domaine qui sera utilisé pour la connection au serveur LDAPS. Il doit être au minimum en lecture seule sur la section du serveur Active Directory pour les deux « Base DN » choisis précédemment. Identifiant pre-Windows 2000 sous la forme UPN (user@example.com).
Pour plus d'informations, vous pouvez vous réfèrer à la documentation VMware à ce sujet.
En complément des informations précédentes, vous devez récupèrer l'empreinte du certificat SSL (SHA1 Fingerprint) du serveur LDAPS Active Directory.
Vous pouvez récupérer cette information par la méthode de votre choix.
- Via cette commande PowerShell sur le serveur Active Directory :
Get-ChildItem -Path Cert:\LocalMachine\MY | Select-Object -property FriendlyName, Subject, NotBefore, NotAfter, @{label='Thumbprint';'Expression'={$_.thumbprint -replace '(..(?!$))','$1:'}}
Ici, il s'agit de la valeur à droite du signe deux-points ( : ) :
> Thumbprint : BB:46:CA:6B:FC:92:4E:96:B4:BB:6E:44:7E:8F:AD:4C:C9:32:AB:AB
- Vous pouvez aussi utiliser la commande OpenSSL suivante (depuis une machine Linux/Unix/Mac distante) :
openssl s_client -connect ad.example.com:636 < /dev/null 2>/dev/null | openssl x509 -fingerprint -noout -in /dev/stdin
Ici, il s'agit de la valeur à droite du signe égal ( = ) :
> SHA1 Fingerprint=BB:46:CA:6B:FC:92:4E:96:B4:BB:6E:44:7E:8F:AD:4C:C9:32:AB:AB
Autoriser la connexion au serveur Active Directory depuis votre Hosted Private Cloud
Récupérez l'adresse IP de votre Hosted Private Cloud par la méthode de votre choix.
Via cette commande sur le serveur Active Directory ou une machine Windows distante :
nslookup pcc-198-51-100-121.ovh.com
Ici, il s'agit de la valeur à la fin de la dernière ligne :
> Address: 198.51.100.121
Il est également possible d'utiliser la commande suivante (depuis une machine Linux/Unix/Mac distante) :
host pcc-198-51-100-121.ovh.com
Ici, il s'agit de la valeur à la fin de la ligne :
> pcc-198-51-100-121.ovh.com has address 198.51.100.121
Utilisez cette adresse IP pour autoriser votre Hosted Private Cloud à accèder à votre serveur LDAPS Active Directory (par défaut sur le port TCP 636).
Cette opération s'effectue dans la configuration du pare-feu de votre Active Directory ou de votre entreprise.
Exemple de configuration de rgle de pare-feu entrant :
| Adresse IP distante (source) | Adresse IP locale (destination) | Port distant (source) | Port local (destination) | Protocole |
|---|---|---|---|---|
| 198.51.100.121 | Toutes les adresses | Tous les ports | 636 | TCP |
Adaptez cette configuration à votre entreprise et mettez en place la régle de pare-feu.
Ajouter votre serveur Active Directory comme source d'authentification
La mise en place d'un serveur Active Directory comme source d'authentification peut être effectuée grâce à l'API OVHcloud.
Récupérez votre « serviceName » en utilisant l'appel API suivant :
Effectuez ensuite la mise en place du serveur Active Directory comme source d'authentification.
Vous devrez spécifier les informations récupérées précédemment. Ne cochez pas la case « noSsl ».
Assurez-vous que l'opération renvoyée s'effectue sans erreur. Vous pouvez la suivre depuis l'espace client OVHcloud, dans l'onglet Opérations de votre Hosted Private Cloud.
Si les informations fournies ne sont pas valides, l'opération concernée sera annulée et un message indiquera l'erreur renvoyée.
Autoriser un utilisateur Active Directory à accéder à votre Hosted Private Cloud
Vous avez la possibilité d'autoriser un utilisateur issu de votre serveur Active Directory à accéder à votre Hosted Private Cloud, grâce à l'API OVHcloud.
Récupérez votre « activeDirectoryId » en utilisant l'appel API suivant :
Effectuez l'ajout de l'utilisateur issu de votre Active Directory.
Vous devrez spécifier le nom d'utilisateur « pre-Windows 2000 » tel qu'indiqué dans votre Active Directory.
Assurez-vous que l'opération renvoyée s'effectue sans erreur. Vous pouvez la suivre depuis l'espace client OVHcloud, dans l'onglet Opérations de votre Hosted Private Cloud.
Si les informations fournies ne sont pas valides, l'opération concernée sera annulée et un message indiquera l'erreur renvoyée.
Une fois autorisé, l'utilisateur et ses permissions seront modifiables directement depuis votre espace client OVHcloud comme n'importe quel utilisateur de votre Hosted Private Cloud.
Par défaut, l'utilisateur ne possède aucune permission sur votre Hosted Private Cloud. Il pourra se connecter à votre Hosted Private Cloud mais n'aura aucun accès. Vous pouvez ajuster les permissions depuis l'espace client.
Autoriser un groupe Active Directory à accéder à votre Hosted Private Cloud
Vous avez la possibilité d'autoriser directement un ensemble d'utilisateurs (groupe) issu de votre serveur Active Directory à accéder à votre Hosted Private Cloud, grâce à l'API OVHcloud.
Récupérez votre « activeDirectoryId » en utilisant l'appel API suivant :
Effectuez l'ajout du groupe issu de votre Active Directory.
Vous devrez spécifier le nom du groupe « pre-Windows 2000 » tel qu'indiqué dans votre Active Directory.
Assurez-vous que l'opération renvoyée s'effectue sans erreur. Vous pouvez la suivre depuis l'espace client OVHcloud, dans l'onglet Opérations de votre Hosted Private Cloud.
Si les informations fournies ne sont pas valides, l'opération concernée sera annulée et un message indiquera l'erreur renvoyée.
Une fois autorisés, le groupe et ses permissions seront modifiables directement depuis votre espace client OVHcloud comme n'importe quel utilisateur de votre Hosted Private Cloud.
Par défaut, le groupe ne possède aucune permission sur votre Hosted Private Cloud. Ses membres pourront se connecter à votre Hosted Private Cloud mais n'auront aucun accès. Vous pouvez ajuster les permissions depuis l'espace client.
Aller plus loin
Échangez avec notre communauté d’utilisateurs sur https://community.ovh.com/.
Cette documentation vous a-t-elle été utile ?
N’hésitez pas à nous proposer des suggestions d’amélioration afin de faire évoluer cette documentation.
Images, contenu, structure… N’hésitez pas à nous dire pourquoi afin de la faire évoluer ensemble !
Vos demandes d’assistance ne seront pas traitées par ce formulaire. Pour cela, utilisez le formulaire "Créer un ticket" .
Merci beaucoup pour votre aide ! Vos retours seront étudiés au plus vite par nos équipes..