# Introduction

Welcome to **SAML.to**!

SAML.to is a bridge between Identity Providers (such as GitHub OAuth) and Service Providers (such as AWS) using the SAML 2.0 Protocol.

It works by adding a configuration file to any repository of your choice called [`saml-to.yml`](https://docs.saml.to/configuration/reference).

The configuration file defines Service Providers (such as AWS) and their configuration.

Also in the configuration file is lists of users that are allowed to access each Service Provider.

Using the SAML.to CLI, users can [`assume`](https://docs.saml.to/usage/cli/assume) to assume roles at those services.

Here's an [Example Configuration file for our Demo Organization](https://github.com/stark-international/saml-to/blob/main/saml-to.yml), **Stark International**

## Ready to Get Started?

[Getting started is easy](https://saml.to/install). This will guide you installing our GitHub application and adding the `saml-to.yml` configuration file to your repository.

Once all set up, granting or removing access to roles is completed by editing the file.

Users granted in the `saml-to.yml` configuration file can visit <https://saml.to/apps> or by using the `saml-to assume` command to assume their granted roles.

See [Installation](https://docs.saml.to/installation) for more details.

### Questions/Comments/Issues?

Please [Contact Us](https://saml.to/contact)!


---

# 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.saml.to/introduction.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.