xen-orchestra/docs/saml.md

# SAML

> SAML authentication plugin for XO-Server

This plugin allows SAML users to authenticate to Xen-Orchestra.

The first time a user signs in, XO will create a new XO user with the same identifier.

## Configuration

In the "Settings" then "Plugins" view, expand the SAML plugin configuration. Then provide the needed fields:

![](./assets/samlconfig.png)

Save the configuration and then activate the plugin (button on top).

> Important: When registering your instance to your identity provider,
> you must configure its callback URL to
> `http://xo.example.net/signin/saml/callback`!

## Debugging

If you can't log in with your SAML settings, please check the logs of `xo-server` while you attempt to connect. It will give you hints about the error encountered. You can do that with a `tail -f /var/log/syslog -n 100` on your XOA.
Create saml.md 2015-11-11 15:11:26 +01:00			`# SAML`

Update saml.md 2015-11-11 15:11:51 +01:00			`> SAML authentication plugin for XO-Server`

			`This plugin allows SAML users to authenticate to Xen-Orchestra.`

			`The first time a user signs in, XO will create a new XO user with the same identifier.`

Update saml.md 2015-11-11 15:14:53 +01:00			`## Configuration`

Update saml.md 2015-11-11 18:08:14 +01:00			`In the "Settings" then "Plugins" view, expand the SAML plugin configuration. Then provide the needed fields:`

chore(all): move assets 2016-07-06 15:00:34 +02:00			`![](./assets/samlconfig.png)`
Update saml.md 2015-11-11 18:08:14 +01:00
			`Save the configuration and then activate the plugin (button on top).`
Update saml.md 2015-11-11 15:14:53 +01:00
			`> Important: When registering your instance to your identity provider,`
			`> you must configure its callback URL to`
			> `http://xo.example.net/signin/saml/callback`!

			`## Debugging`

chore(all): major reorg of the doc 2016-07-04 17:05:27 +02:00			If you can't log in with your SAML settings, please check the logs of `xo-server` while you attempt to connect. It will give you hints about the error encountered. You can do that with a `tail -f /var/log/syslog -n 100` on your XOA.