## Documentation

- About
- Read First
  - What is IdentityServer
  - Installation Scenarios
- Migrations
- Bootstrapping
- Configuration & Integration
  - AdminUI Settings
  - Configuring AdminUI
  - Configuring AdminUI (NuGet)
  - Integrating with Identity Server
  - Integrating with Identity Server Custom Schema
  - Integrating with Quickstarts
  - Enabling Logging
- Installation
  - Installer
  - IIS
  - Azure
    - Install in Azure
    - Create Azure Web App
  - Docker
  - NuGet
- Custom Database Connections
- Custom Identity Store
  - Overview
  - Partial Implementation
  - Full Implementation
  - Tenancy With Entity Framework
  - NoSql Implementation (MongoDB)
- Users
  - Searching for Users
  - Adding Users
  - Editing Users
  - Deleting Users
  - Merge Users
  - Set User Password
  - Session Management
  - User Reports
- Roles
  - Creating Roles
  - Managing Roles
  - Managing Users in a Role
- Claim Types
- Clients
  - Searching for Clients
  - Adding Clients
  - Adding a SAML Client
  - Adding a WS-Fed Client
  - Editing Clients
  - Deleting Clients
  - Clone Client
- Import and Export
  - Exporting Clients
  - Importing Clients
  - Importing Client Configuration with Secrets
  - Importing SAML Clients with Certificates
  - Import and Export Via the API
- Dynamic Authentication Providers
  - What is Dynamic Authentication
  - Enabling or disabling Dynamic Authentication
  - Add a Dynamic Provider
    - First Steps
    - Adding OIDC Provider
    - Adding SAML Provider
  - Edit a Dynamic Provider
    - Accessing edit view
    - Editing a OIDC Provider
    - Editing a SAML Provider
  - Deleting a Provider
  - Searching for Provider
- Resources
  - Searching for Resources
  - Creating Resources
  - Editing resources
- Webhooks
  - Webhooks
  - Endpoint Configuration
- User Settings Endpoints
- Access Policy
- Auditing
- FAQs
- Troubleshooting
  - Unable to load AdminUI web page
  - Unable to contact IdentityServer
  - Unable to contact API
  - Unable to log in

### Adding a SAML Client

- -Setting up a SAML Client with AdminUI and SAML2P
- -Configuring a SAML Client.

## Setting up a SAML Client with AdminUI and SAML2P

In order to set up a new SAML Service Provider client you will need to Navigate to /clients and click the "Add Client" button and select SAML Service Provider from the list of client types.

*Note you will need a license for SAML2P in order to integrate with a SAML Client. You can get a demo license by visiting our SAML2P product page

If you have a SAML metadata document from the SAML Identity Provider you are connecting to, you can fill in most of these fields using that.

Name | Type | Description
--- | --- | ---
`EntityID` | SAML Entity ID | SAML Entity ID (This will be in the metadata document)
`DisplayName` | Client display name | Client Display Name used in AdminUI, this has no effect on the Client itself
`Description` (Optional) | Description of the client | Description of the Client, may be left blank.
`ASC Endpoint` (http:// or https://) | AssertionConsumerService | AssertionConsumerService, can be found in your metadata file, made of an Endpoint, an Index and a binding type.
`SLO Endpoint` (Optional) (http:// or https://) | SingleLogoutService | SingleLogoutService, can be found in your metadata file, made of an Endpoint, an Index and a binding type.

*ACS/SLO Endpoints are required to be in a valid http:// or https:// format. Although it is always recommended to use TLS in production for security.

If additional ACS/SLO Endpoints are required, they may be set after Client creation in the Client Configuration pages. Find out more info on how to configure a SAML Client

The next screen allows you to enter the Identity Resources your client will be able to access. This list comes from the list of predefined Identity Resources. You must select at least one Identity Resource to proceed to the next screen.

The final screen allows you to view the summary of the proposed client application and make any appropriate changes.

## Configuring a SAML Client.

Once a SAML Client has been created it can be further configured by finding the Client within the Clients page and clicking on it. Here it is possible to modify more advanced settings, add additional resources, modify ACS/SLO Endpoints and access audits specific to the Client.

The SAML tab contains the Clients SAML specific settings;

Name | Description
--- | ---
`ACS Endpoints` | Add, remove or edit ACS endpoints
`SLO Endpoints` | Add, remove or edit SLO endpoints
`Claims Mappings` | Map AdminUI Claim Types to Saml ClaimTypes
`Request` | Add, remove and configure signing certificates
`Response` | Add, replace or remove and configure an encryption certificate

To find out about all of the possible configurable options for a SAML Service Provider, vist our SAML2P documentation

Previous Next