> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-system-administrators/configuration/saml-config.md).

# SAML config

## First: The easy part

Please read through our [fylr-SAML tutorial](/tutorials/auth/saml.md), we describe the basics there and guide you through the steps once. Then come back here for the advanced topics only.

## Renewal of the identity provider metadata in fylr

This is also relevant for new **certificates** of the IdP, which are part of the metadata.

fylr only fetches metadata from the configured **IdP metadata URL** at the following events:

* fylr starts
* SAML section in Base Config is changed and saved, this applies to the following fields:\
  `URL`, `Cert`, `Key`, `SignRequest`, `ServiceProviderEntityID`, `IdentityProviderEntityID`, `Debug`<br>
