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

Initial pass at stories for token registration #69

Open
wants to merge 7 commits into
base: main
Choose a base branch
from

Conversation

dangorst1066
Copy link

Hey @mikeshng @skeeey @qiujian16 - as per discussion on Slack, firing over a PR covering the admin developer experience of joining/accepting clusters using token registration - just to get the conversation started. Technical details/impl notes/testing etc still need to be added to the doc

@openshift-ci openshift-ci bot requested review from deads2k and qiujian16 July 11, 2022 09:30
@qiujian16
Copy link
Member

Thanks!

1. OCM agents in the spoke cluster were offline (e.g. due to an outage) during which its service account token expired
2. A network outage resulted in the spoke cluster loosing connectivity to the hub api server for an extended period of time
3. A service account was intentionally deleted (e.g. the associated token was compromised) and replaced.

Copy link
Member

Choose a reason for hiding this comment

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

we should have another story about addons. I think in token base approach, addons also need to use token to talk to the hub.

Copy link
Author

Choose a reason for hiding this comment

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

Added 👍

@qiujian16
Copy link
Member

alternatively, we could build a front-proxy for kube-apiserver, the front-proxy can use mtls with a customized signer.

@openshift-ci
Copy link

openshift-ci bot commented Jul 22, 2022

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: dgorst
Once this PR has been reviewed and has the lgtm label, please assign qiujian16 for approval by writing /assign @qiujian16 in a comment. For more information see:The Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@@ -0,0 +1,157 @@
## Release Signoff Checklist
Copy link

Choose a reason for hiding this comment

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

Please add https://github.com/open-cluster-management-io/api/blob/main/docs/clusterjoinprocess.md as a see-also. It may be worth it to move the doc into this repo.

That doc outlines the current process and a few key features of the flow are visible there:

  1. the subject has a group associated with the managedcluster and the name has an agent associated with the process on that managedcluster
  2. an agent on the managedcluster is able to get new agent credentials by using shared (non-agent) credentials to create a request and the hub admin can approve or reject.
  3. an agent on the managedcluster is able renew credentials to identify itself. This also allows for non-shared credential flows.
  4. different agents on the managed cluster are members of the same group and have different names, with the agent clearly identified
  5. the hub admin gets a choice about whether or not to allow a particular managecluster to get a valid credential
  6. the hub admin can control expiry/removal of a particular agent. In this case, by rotating the signing credential. (Different distros are better or worse at doing this.)

Any new flow that is developed should allow the same capabilities and should use the standard group and usernames to ease adoption. Capability 2 may be negotiable (not required), but it would be limiting because the hub would need to communicate unique credentials to each managed cluster.

Copy link
Author

Choose a reason for hiding this comment

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

👍 Added to implementation details section

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants