> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/fr/securite/enterprise-security/ws-federation.md).

# WS-Federation

Configurer l'authentification WS-Federation dans PowerShell Universal avec ADFS ou Azure Active Directory, y compris la mise en place de l'approbation de partie de confiance.

{% hint style="info" %}
WS-Federation nécessite une [licence](https://store.devolutions.net/package#psu).
{% endhint %}

WS-Federation prend en charge à la fois Active Directory Federation Services et Azure Active Directory.

Vous devez d'abord configurer ADFS ou AzureAD pour prendre en charge Universal.

## Configuration d'ADFS pour Universal <a href="#configuring-adfs-for-universal-dashboard" id="configuring-adfs-for-universal-dashboard"></a>

### Paramètres du service <a href="#service-settings" id="service-settings"></a>

Tout d'abord, vous devrez recueillir les propriétés du service de fédération depuis ADFS. Ouvrez l'appli AD FS (Microsoft.IdentityServer.msc). Ensuite, cliquez sur Service, puis sur Modifier les propriétés du service de fédération.

Cela ouvrira une boîte de dialogue contenant les valeurs de votre service ADFS. Vous aurez besoin de ces valeurs pour configurer PowerShell Universal.

### Parties de confiance <a href="#relying-parties" id="relying-parties"></a>

Si aucune approbation de partie de confiance n'est configurée, cliquez sur Ajouter une approbation de partie de confiance. Sélectionnez Compatible avec les revendications.

Sélectionnez Saisir manuellement les données concernant la partie de confiance.

Spécifiez un nom pour la partie de confiance.

Activez le protocole passif WS-Federation. Saisissez l'URL du serveur PowerShell Universal avec une barre oblique à la fin.

Saisissez l'URL de votre serveur PowerShell Universal.

Après avoir terminé la configuration de votre approbation de partie de confiance, vous devrez mettre en place une stratégie d'émission de revendications. Créez une règle de transformation d'émission qui envoie au moins le Name et le Name ID à Universal.

Vous pouvez configurer des revendications supplémentaires que vous souhaitez utiliser si vous employez des stratégies dans Universal.

### Dépannage

MSIS7065: There are no registered protocol handlers on path /adfs/ls to process the incoming request.

Ce problème peut survenir si la page de connexion initiée par l'IDP est désactivée. Il s'agit du comportement par défaut. Exécutez la commande suivante à partir d'une console d'administration.

{% code collapsedlinecount="10" %}

```powershell
 Set-AdfsProperties -EnableIdPInitiatedSignonPage $true
```

{% endcode %}

MSIS7001: The passive protocol context was not found or not valid. If the context was stored in cookies, the cookies that were presented by the client were not valid. Ensure that the client browser is configured to accept cookies from this website and retry this request.

## Configuration pour Azure Active Directory <a href="#configuring-for-azure-active-directory" id="configuring-for-azure-active-directory"></a>

Suivez la documentation pour la configuration d'Azure Active Directory que vous trouverez dans ce [document Microsoft](https://docs.microsoft.com/en-us/aspnet/core/security/authentication/ws-federation?view=aspnetcore-2.2#azure-active-directory).

## Configuration d'Universal <a href="#configuring-universal-dashboard" id="configuring-universal-dashboard"></a>

### Utiliser Appsettings.json

Après avoir configuré ADFS ou AAD, vous pouvez maintenant fournir les propriétés à Universal pour MetadataAddress et Wtrealm. Informez-vous sur ces paramètres sur notre page [Paramètres ](/powershell-universal/fr/config/settings.md).

Voici un exemple de la façon de mettre à jour le fichier `appsettings.json` pour y appliquer les bons paramètres pour WS-Federation.

{% code collapsedlinecount="10" %}

```javascript
{
  "Kestrel": {
    "Endpoints": {
      "HTTP": {
        "Url": "http://*:5000"
      }
    },
    "RedirectToHttps": "false"
  },
  "ApplicationInsights": {
    "InstrumentationKey": ""
  },
  "Logging": {
    "Path": "%PROGRAMDATA%/PowerShellUniversal/log.txt",
    "RetainedFileCountLimit": 31,
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "CorsHosts": "",
  "Data": {
    "RepositoryPath": "%ProgramData%\\UniversalAutomation\\Repository",
    "ConnectionString": "%ProgramData%\\UniversalAutomation\\database.db",
    "GitRemote": "",
    "GitUserName": "",
    "GitPassword": "", 
    "ConfigurationScript": ""
  },
  "Api": {
    "Url": ""
  },
  "Authentication" : {
    "Windows": {
      "Enabled": "false"
    },
    "WSFed": {
        "Enabled": "true",
        "MetadataAddress": "https://ironman.local:443/FederationMetadata/2007-06/FederationMetadata.xml",
        "Wtrealm": "https://ironman.local:12345",
        "CallbackPath": "/auth/signin-wsfed"
    },
    "OIDC": {
      "Enabled": "false",
      "CallbackPath": "/auth/signin-oidc",
      "ClientID": "",
      "ClientSecret": "",
      "Resource": "",
      "Authority": "",
      "ResponseType": "",
      "SaveTokens": "false"
    },
    "SessionTimeout": "25"
  },
  "Jwt": {  
    "SigningKey": "PleaseUseYourOwnSigningKeyHere",  
    "Issuer": "IronmanSoftware",
    "Audience": "PowerShellUniversal"
  },
  "UniversalDashboard": {
    "AssetsFolder": "%ProgramData%\\PowerShellUniversal\\Dashboard"
  },
  "ShowDevTools": false,
  "HideAdminConsole": false
}
```

{% endcode %}

Lors de l'exécution de votre serveur, vous devriez maintenant être invité à saisir vos identifiants, soit par le système d'authentification unique d'Internet Explorer, soit vous serez redirigé vers la page de connexion WS-Fed.

### Utiliser Authentication.ps1

Vous pouvez configurer l'authentification WS-Federation dans la console d'administration. Pour ce faire, naviguez vers Secure > Authentication. Ajoutez le fournisseur WS-Federation en le sélectionnant dans la liste déroulante en haut à droite.

Ensuite, modifiez les propriétés du fournisseur d'authentification et spécifiez les détails de configuration de votre installation ADFS.

Une fois configuré, activez le fournisseur WS-Federation. Ensuite, déconnectez-vous et naviguez vers `/admin` Vous serez invité à vous connecter à votre fournisseur WS-Federation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/fr/securite/enterprise-security/ws-federation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
