# 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)!