This repo contains the documentation for Single Sign-On for VMware Tanzu, which enables users to authenticate with an external identity provider rather than having to create a new account or re-enter credentials. Single Sign-On grants users centralized access to applications in various spaces, as well as to Ops Manager, Apps Manager, and other Cloud Foundry components.

docs-book-identity

docs-book-runpivotal

1. Clone https://github.com/pivotal-cf/docs-layout-repo
2. Clone https://github.com/pivotal-cf/docs-book-identity. Check out branch edge of this repo, verify that this branch has a config.yml that contains the newest SSO version properties. Create feature branch out of edge of to hold changes in sidebar structure and texts.
3. Clone https://github.com/pivotal-cf/docs-identity. Read the README of this repo to decide which branch to check out. Create feature branch out of the appropriate branch to hold changes in the actual documentation text content.
4. Get ruby 2.3.0 and follow steps on https://github.com/pivotal-cf/bookbinder
5. cd docs-book-identity && bundle install
6. To render the documentation with hotload changes: cd docs-book-identity && bundle exec bookbinder watch (Browse to localhost url in the output, for example, localhost:4567/p-identity/1-n).

1. Check out master branch.
2. Create a feature branch with a branch name reflecting the purpose of the edit. E.g.: git checkout -b update-product-version
3. Commit onto the feature branch, and push the feature branch.
4. Create PR to request that the feature branch be merged into master, and include any appropriate contexts in the PR.
5. Docs team will review the PR and delete the feature branch once it is merged.

SSO has a lot of difficult and inconsistent terminology. Jane learned the following, working with Peter Chen in early July 2018.