# SSO

We provide seamless Single Sign-On (SSO) integration for both private cloud environments and on-premises installations. Our solution ensures secure, streamlined access, enhancing user experience and simplifying identity management across various platforms.

In order to set up SSO, please provide the following information: 

1. Do you use only the web client or the desktop client as well?
2. Please share with us the XML file containing IdP federation metadata
3. Furthermore, we need the configuration of aqua as an SP (Service Provider), giving it a unique EntityId (e.g. aqua),  with following back-urls: <br>

* `http[s]://aqua-server/aquaWebNG/Account/saml2-acs as AssertionConsumerService` as AssertionConsumerService
* `http[s]://aqua-server/aquaWebNG/Account/saml2-logout` as SingleLogoutService
* where `http[s]://aqua-server/aquaWebNG/` is the url where aquaWebNG is deployed and accessible.&#x20;

To integrate properly, clarify which attribute in the SSO response (`/samlp:Response/saml:Assertion/saml:AttributeStatement/` section) will contain the aqua username. This is usually `uid`, but it depends on the actual SAML 2.0 SSO configuration.

###

{% hint style="info" %}
We recommend enforcing HTTPS for all communications. Although both HTTP and/or HTTPS links can be configured based on customer deployment, HTTPS should be prioritized.&#x20;
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aqua-cloud.io/documentation/integrations/sso.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.