Add an example of how to use a SAML Identity Provider with Cognito

[AaronKalair]

Community Note

• Please vote on this pull request by adding a 👍 reaction to the original pull request comment to help the community and maintainers prioritize this request
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for pull request followers and do not help prioritize the request

Release note for CHANGELOG:

Adds documentation about using the `aws_cognito_identity_provider` resource with a SAML identity provider

Hi,

This is my first PR to your project, I tried to follow the guidelines, let me know if I missed anything.

I was using the aws_cognito_identity_provider resource and was a little unsure how to use it with a SAML identity provider specifically around passing in the MetadataFile so I've updated the documentation to add an example.

[mohsen0]

This is needed.

[burib]

@AaronKalair do you know by any chance how to configure the "Enable IdP sign out flow" option ?

[burib]

@AaronKalair I actually found it in https://github.com/aws/aws-sdk-go/blob/4fd654616873ce70fdef7657132e7106e96a23d7/models/apis/cognito-idp/2016-04-18/docs-2.json#L2113

  MetadataFile OR MetadataURL
  IDPSignOut ( optional ) ( boolean )

[zhelding]

Pull request #21306 has significantly refactored the AWS Provider codebase. As a result, most PRs opened prior to the refactor now have merge conflicts that must be resolved before proceeding.

Specifically, PR #21306 relocated the code for all AWS resources and data sources from a single aws directory to a large number of separate directories in internal/service, each corresponding to a particular AWS service. This separation of code has also allowed for us to simplify the names of underlying functions -- while still avoiding namespace collisions.

We recognize that many pull requests have been open for some time without yet being addressed by our maintainers. Therefore, we want to make it clear that resolving these conflicts in no way affects the prioritization of a particular pull request. Once a pull request has been prioritized for review, the necessary changes will be made by a maintainer -- either directly or in collaboration with the pull request author.

For a more complete description of this refactor, including examples of how old filepaths and function names correspond to their new counterparts: please refer to issue #20000.

For a quick guide on how to amend your pull request to resolve the merge conflicts resulting from this refactor and bring it in line with our new code patterns: please refer to our Service Package Refactor Pull Request Guide.