Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Identity Center Okta to Teleport migration guide #51861

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

tcsc
Copy link
Contributor

@tcsc tcsc commented Feb 5, 2025

No description provided.

@tcsc tcsc added the no-changelog Indicates that a PR does not require a changelog entry label Feb 5, 2025
Copy link

github-actions bot commented Feb 5, 2025

Amplify deployment status

Branch Commit Job ID Status Preview Updated (UTC)
tcsc/ic-migration-guide HEAD 1 ✅SUCCEED tcsc-ic-migration-guide 2025-02-05 06:16:39

Copy link
Collaborator

@r0mant r0mant left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks reasonable, left a few things to consider.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's please use LucidChart for the diagrams so all the graphics in our documentation are consistent.

Identity Center users and groups to Teleport management, including having
Teleport control individual user and group Account Assignments.

By default, Teleport wants to control all user and group provisioning into
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
By default, Teleport wants to control all user and group provisioning into
By default, Teleport controls all user and group provisioning into

- watching the Teleport logs

Once your Okta users are imported into Teleport, you can progress to the next
step:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
step:
step.

sync has occurred. You can verify this by either
- refreshing the user page and finding your Okta users,
- checking the Okta integration status page, or
- watching the Teleport logs
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: I'd remove this one in favor of the previous two more user-friendly options. Plus, it won't suit Cloud customers.

Suggested change
- watching the Teleport logs

Comment on lines +126 to +128
--user-origin okta \
--account-name ${ACCOUNT_NAME_ALLOW_FILTER} \
--group-name ${GROUP_NAME_ALLOW_FILTER}
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A logical question that arises, how can these filters be updated after the integration has been created? I didn't see a mention of this later in the guide.


For more information, see the [Identity Center Integration guide](./aws-iam-identity-center.mdx)

## Step 6: Retire Okta group provisioning
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should probably also include a section on how to unenroll the Teleport integration side of this as well in case someone decides they don't want to switch yet.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
aws-iam-identity-center documentation no-changelog Indicates that a PR does not require a changelog entry
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants