mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
81 lines
2.8 KiB
Plaintext
81 lines
2.8 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * rosa_learning/creating_cluster_workshop/learning-getting-started-idp.adoc
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="learning-getting-started-idp-creating_{context}"]
|
|
= Setting up an IDP with GitHub
|
|
|
|
[role="_abstract"]
|
|
You can use GitHub to set up your identity provider.
|
|
|
|
.Procedure
|
|
. Log in to your GitHub account.
|
|
. Create a new GitHub organization where you are an administrator.
|
|
+
|
|
[TIP]
|
|
====
|
|
If you are already an administrator in an existing organization and you want to use that organization, skip to step 9.
|
|
====
|
|
+
|
|
. Click the *+* icon, then click *New Organization*.
|
|
+
|
|
image::cloud-experts-getting-started-idp-new-org.png[]
|
|
|
|
. Choose the most applicable plan for your situation or click *Join for free*.
|
|
|
|
. Enter an organization account name, an email, and whether it is a personal or business account. Then, click *Next*.
|
|
+
|
|
image::cloud-experts-getting-started-idp-team.png[]
|
|
|
|
. *Optional:* Add the GitHub IDs of other users to grant additional access to your {product-title} cluster. You can also add them later.
|
|
. Click *Complete Setup*.
|
|
. *Optional:* Enter the requested information on the following page.
|
|
. Click *Submit*.
|
|
. Go back to the terminal and enter the following command to set up the GitHub IDP:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
rosa create idp --cluster=<cluster name> --interactive
|
|
----
|
|
|
|
. Enter the following values:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
Type of identity provider: github
|
|
Identity Provider Name: <IDP-name>
|
|
Restrict to members of: organizations
|
|
GitHub organizations: <organization-account-name>
|
|
----
|
|
|
|
. The CLI will provide you with a link. Copy and paste the link into a browser and press *Enter*. This will fill the required information to register this application for OAuth. You do not need to modify any of the information.
|
|
+
|
|
image::cloud-experts-getting-started-idp-link.png[]
|
|
|
|
. Click *Register application*.
|
|
+
|
|
image::cloud-experts-getting-started-idp-register.png[]
|
|
|
|
. The next page displays a *Client ID*. Copy the ID and paste it in the terminal where it asks for *Client ID*.
|
|
+
|
|
[NOTE]
|
|
====
|
|
Do not close the tab.
|
|
====
|
|
|
|
. The CLI will ask for a *Client Secret*. Go back in your browser and click *Generate a new client secret*.
|
|
+
|
|
image::cloud-experts-getting-started-idp-secret.png[]
|
|
|
|
. A secret is generated for you. Copy your secret because it will never be visible again.
|
|
|
|
. Paste your secret into the terminal and press *Enter*.
|
|
. Leave *GitHub Enterprise Hostname* blank.
|
|
. Select *claim*.
|
|
. Wait approximately 1 minute for the IDP to be created and the configuration to land on your cluster.
|
|
+
|
|
image::cloud-experts-getting-started-idp-inputs.png[]
|
|
|
|
. Copy the returned link and paste it into your browser. The new IDP should be available under your chosen name. Click your IDP and use your GitHub credentials to access the cluster.
|
|
+
|
|
image::cloud-experts-getting-started-idp-login.png[] |