Jordan : /* Script de création d'identifiant */

2021-01-22T14:26:20Z

Script de création d'identifiant

Jordan : /* Script appelant un identifiant */

2021-01-22T14:25:44Z

Script appelant un identifiant

Jordan le 22 janvier 2021 à 11:13

2021-01-22T11:13:16Z

Jordan : Page créée avec « ==Présentation== Cette page a pour objet de décrire comment gérer des identifiants avec PowerShell. »

2021-01-20T10:17:04Z

Page créée avec « ==Présentation== Cette page a pour objet de décrire comment gérer des identifiants avec PowerShell. »

Nouvelle page

==Présentation==
Cette page a pour objet de décrire comment gérer des identifiants avec PowerShell.

@@ Ligne 37 : / Ligne 37 : @@
 ===Script de création d'identifiant===
 Le script suivant, nommé, par exemple, <code>create_credentials.ps1</code>, est utilisable de façon interactive :
-<syntaxhighlight lang="powershell" line highlit="7">
+<syntaxhighlight lang="powershell" line highlight="7">
 #!/usr/bin/pwsh

@@ Ligne 76 : / Ligne 76 : @@
 # Dossier des identifiants
 $CredsFileLocation="/data/scripts/.credentials"
 # Construction des fichiers d'identifiants à utiliser

← Version précédente		Version du 22 janvier 2021 à 11:13
Ligne 1 :		Ligne 1 :
	==Présentation==		==Présentation==
	Cette page a pour objet de décrire comment gérer des identifiants avec PowerShell.		Cette page a pour objet de décrire comment gérer des identifiants avec PowerShell.
		+
		+	==Contexte==
		+	Dans le cadre de rédaction de scripts PowerShell, ils peuvent être amenés à être joués de façon automatique et récurrente.
		+
		+	A ce titre, s'ils doivent utiliser des identifiants pour se connecter à des ressources, il est bien évidemment fortement déconseillé de stocker des mots de passe en clair dans les scripts.
		+
		+	Une des solutions pour éviter l'usage de mots de passe en clair est d'utiliser un objet [https://docs.microsoft.com/en-us/dotnet/api/system.management.automation.pscredential Credential] (identifiant). Cet objet, au travers de la méthode [https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/export-clixml Export-Clixml], permet de stocker le mot de passe :
		+	*de façon cryptée sur les système Windows
		+	*sous forme de tableau de caractères Unicode sur les systèmes non-Windows.
		+
		+	''"Export-Clixml exporte uniquement les informations d'identification cryptées sous Windows. Sur les systèmes d'exploitation non Windows tels que macOS et Linux, les informations d'identification sont exportées sous forme de texte brut stocké sous forme de tableau de caractères Unicode. Cela fournit un certain obscurcissement mais ne fournit pas de chiffrement."''<ref>Documentation officielle PowerShell de l'applet Export-Clixml (https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/export-clixml#example-3--encrypt-an-exported-credential-object-on-windows)</ref>
		+
		+	La solution présentée ici est une solution parmi d'autres, et ne fait pas autorité en la matière.
		+
		+	==Mise en œuvre==
		+	Dans l'idée, il faudra avoir 3 fichiers :
		+	*un fichier dans lequel stocker le mot de passe
		+	*un script permettant de créer les identifiants
		+	*un script lambda ayant besoin d'utiliser un des mots de passe stockés
		+
		+	===Fichier pour mot de passe===
		+	La gestion des mots de passe au travers de la méthode [https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/export-clixml Export-Clixml] ne permet pas de stocker plusieurs utilisateurs. En effet, un identifiant correspond à un objet et la méthode [https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/export-clixml Export-Clixml] stocke un objet dans un fichier.
		+
		+	Il va donc falloir respecter une convention de nommage afin de pouvoir organiser les mots de passe. Par exemple : <code><serveur>_<utilisateur>.xml</code>.
		+
		+	Il faudra également stocker ces fichiers dans un répertoire dont l'accès sera sécurisé. Par exemple : <code><chemin_du_dossier>/<mon_dossier_caché></code>.
		+
		+	Ainsi, nous pourrions avoir, par exemple, un dossier <code>/data/scripts/.credentials</code> qui contiendrait les fichiers suivants :
		+	<pre>
		+	/data/scripts/.credentials/myserver1_root.xml
		+	/data/scripts/.credentials/myserver2_www.xml
		+	/data/scripts/.credentials/mybackupserver_admin.xml
		+	</pre>
		+
		+	===Script de création d'identifiant===
		+	Le script suivant, nommé, par exemple, <code>create_credentials.ps1</code>, est utilisable de façon interactive :
		+	<syntaxhighlight lang="powershell" line highlit="7">
		+	#!/usr/bin/pwsh
		+
		+	## Script pour créer des credentials
		+
		+	## Initialisation des variables
		+	# Stockage des fichiers de credentials
		+	$location = "/data/scripts/.credentials"
		+
		+	# Demande du serveur concerné par les credentials
		+	$server = Read-Host -Prompt 'Veuiller renseigner le serveur '
		+
		+	# Demande du nom d'utilisateur et du mot de passe
		+	$cred = Get-Credential -Message "Veuillez renseigner l'utilisateur et le mot de passe :"
		+
		+	# Fichier dans lequel enregistrer les credentials
		+	$file = $($location + "/" + $server + "_" + $cred.UserName + "_ps.xml")
		+
		+	# Enregistrement des credentials dans un fichier
		+	$cred \| Export-Clixml -Path $file
		+
		+	# Sécurisation du fichier en modifiant ses droits d'accès
		+	chmod 0600 $file
		+
		+	Write-Host "Fichier de credentials $file créé avec succès !"
		+	</syntaxhighlight>
		+
		+	La seule contrainte sera de penser à renseigner la ligne <code>7</code> pour indiquer dans quel dossier sera enregistré le fichier d'identifiant.
		+
		+	===Script appelant un identifiant===
		+	Une fois le ou les fichier(s) d'identifiant créé(s), il(s) devra/devront être appelé(s) de la façon suivante :
		+	<syntaxhighlight lang="powershell">
		+	#!/usr/bin/pwsh
		+
		+	# Penser à utiliser le script create_credentials.ps1 pour créer les credentials
		+
		+	## Initialisation variables
		+	# Dossier des identifiants
		+	$CredsFileLocation="/data/scripts/.credentials"
		+
		+	# Construction des fichiers d'identifiants à utiliser
		+	$FileCredsA=$($CredsFileLocation + "/" + $serverA+ "_" + $userA+ "_ps.xml")
		+	$FileCredsB=$($CredsFileLocation + "/" + $serverB+ "_" + $userB+ "_ps.xml")
		+
		+	# Importation des credentials
		+	$CredsA=Import-Clixml -Path $FileCredsA
		+	$CredsB=Import-Clixml -Path $FileCredsB
		+
		+	# Exemple d'utilisation d'un objet d'identifiant
		+	New-SSHSession -ComputerName $serverA -Credential $CredsA
		+
		+	# Exemple d'utilisation avec récupération en clair du mot de passe de l'utilisateur B
		+	$PasswdB=$CredsB.GetNetworkCredential().Password
		+	</syntaxhighlight>
		+
		+	==Références==
		+	<references />

Technique/PowerShell/Gérer des identifiants - Historique des versions

Jordan : /* Script de création d'identifiant */

Jordan : /* Script appelant un identifiant */

Jordan le 22 janvier 2021 à 11:13

Jordan : Page créée avec « ==Présentation== Cette page a pour objet de décrire comment gérer des identifiants avec PowerShell. »