Étape 3 : Installation de Jamf AD CS Connector pour le mode de communication sortant - Document technique : Intégration à Active Directory Certificate Services (AD CS) avec Jamf Pro

Avant de pouvoir réaliser l’intégration à AD CS avec Jamf Pro, vous devez installer le connecteur Jamf AD CS sur un serveur Windows. Le connecteur s’exécute en tant que service qui permet à Jamf Pro de communiquer avec le serveur de l’autorité de certification AD CS.

Remarque :

PowerShell dispose d’un réglage de sécurité qui ne permet pas l’exécution de scripts non signés numériquement. Vous pouvez obtenir ce réglage en exécutant la commande suivante à partir de l’invite PowerShell :

Get-ExecutionPolicy

Si la valeur renvoyée est RemoteSigned, les scripts doivent être signés avant d’être exécutés. Vous pouvez modifier temporairement ce réglage en exécutant la commande suivante :

Set-ExecutionPolicy unrestricted

Connectez-vous au serveur Windows qui hébergera le connecteur Jamf AD CS en tant qu’utilisateur disposant de privilèges d’administrateur.
Cliquez sur le lien suivant dans la section Produits de Jamf Account, puis cliquez sur Télécharger . https://account.jamf.com/products/other/ad-cs-connector/download.
Extrayez le fichier téléchargé.
Ouvrez une console PowerShell en tant qu’administrateur puis changez de répertoire pour afficher le dossier « Connecteur AD CS » décompressé (par exemple C:\Users\administrator\Downloads\adcs-connector-x.x.x\ADCS Connector).

Exécutez la commande suivante pour afficher les options de configuration :

# display outbound connector installation options 
.\install-adcs-connector.ps1 -outbound -help

Affichez les paramètres de configuration nécessaires et leurs valeurs par défaut, puis déterminez tous les changements de configuration qui s’imposent. Il n’est pas recommandé de modifier les tailles ou les intervalles de lot pour l’interrogation ou la publication.


Paramètre	Description	Valeur par défaut
`clientId`	Identifiant du client de l’API que vous avez prévu d’utiliser avec AD CS Connector et qui a été déterminé lors d’une étape précédente	S. O.
`clientSecret`	Secret du client de l’API associé à l’identifiant client et qui a été déterminé lors d’une étape précédente	S. O.
`jamfProUrl`	URL de votre serveur Jamf Pro	S. O.
`adcsId`	Identifiant associé à l’intégration AD CS spécifique et qui été déterminé lors d’une étape précédente	S. O.
`pollingInterval`	Intervalle d’interrogation en secondes	10 secondes
`jobBatchSize`	Taille du lot	100 demandes de certificat
`publishInterval`	Intervalle de publication des résultats de retour dans Jamf Pro en secondes	3 secondes
`publishBatchSize`	Taille du lot de publication des résultats de retour dans Jamf Pro	100 certificats
`outboundDirBase`	Répertoire de base pour l’installation	${env:programfiles(x86)}\adcs-connector\outbound
`serviceDisplayName`	Nom d’affichage du service	AdcsConnectorOutbound

Remarque :

Si vous voulez exécuter Jamf AD CS Connector comme utilisateur de service (par exemple, pour un compte de service classique ou un compte de service géré par un groupe), procédez comme suit :

Dans la propriété -serviceUser, renseignez votre utilisateur au format DOMAIN\userName.
Si votre utilisateur de service a besoin d’un mot de passe, indiquez-le à l’aide du paramètre -servicePassword.
Donnez à votre utilisateur de service un accès en lecture/écriture filesystem aux répertoires suivants :
- %PROGRAMDATA%\Jamf\AdcsConnector\Logs\Jamf-ADCS-Connector\AdcsConnectorOutbound_.log – Il s’agit de l’emplacement du fichier journal.
- C:\Program Files (x86)\adcs-connector (ou la valeur fournie pour outboundDirBase si vous n’utilisez pas la valeur par défaut)

Exécutez le script PowerShell install-adcs-connector.ps1, y compris toutes les valeurs de paramètres personnalisés que vous avez définies lors des étapes précédentes.
L’exemple suivant montre les paramètres minimum requis pour exécuter le script d’installation :
```
# install the outbound connector 
.\install-adcs-connector.ps1 -outbound -install -clientId API_client_ID -clientSecret API_client_secret -jamfProUrl JAMF_PRO_URL -adcsId adcsid
```
L’exemple complet ci-dessous utilise les valeurs suivantes :
- clientId : adf5ba29-f805-4bd1-862f-1b8b19e02071
- clientSecret : tCaxEHWGq9OYXsje0nDUBZlChnSJxRie-EeML2l4iFNkik5ENAJNWszMXwm8BgMs
- jamfProURL : https://jamf_pro_url.jamfcloud.com/
- adcsId : 3
```
# install the outbound connector 
.\install-adcs-connector.ps1 -outbound -install -clientId adf5ba29-f805-4bd1-862f-1b8b19e02071 -clientSecret tCaxEHWGq9OYXsje0nDUBZlChnSJxRie-EeML2l4iFNkik5ENAJNWszMXwm8BgMs -jamfProUrl https://jamf_pro_url.jamfcloud.com/ -adcsId 3
```

Jamf AD CS Connector s’installe en mode de communication sortant avec les valeurs et paramètres fournis.

Pour modifier des paramètres de configuration, vous devez réexécuter le script d’installation PowerShell avec toutes les valeurs de configuration requises. Pour modifier le paramètre serviceDisplayName, vous devrez désinstaller le connecteur précédent.