From a3bf33911cd581a9c64deae855df9d44b5996d93 Mon Sep 17 00:00:00 2001 From: Christina Koch Date: Mon, 16 Sep 2024 13:13:49 -0500 Subject: [PATCH 1/5] changing ssh registry link to logout --- documentation/overview/account_setup/ap7-access.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/overview/account_setup/ap7-access.md b/documentation/overview/account_setup/ap7-access.md index 65a3288..e3c1d22 100644 --- a/documentation/overview/account_setup/ap7-access.md +++ b/documentation/overview/account_setup/ap7-access.md @@ -18,7 +18,7 @@ To join and use the `uw.osg-htc.org` Access Points (`ap40.uw.osg-htc.org`), you To request access to `ap40.uw.osg-htc.org`, submit an application using the following steps: -1. To request an OSPool account, visit this account [registration page](https://registry.cilogon.org/registry/co_petitions/start/coef:211). OSG User School 2024 participants should use [this link](https://registry.cilogon.org/registry/co_petitions/start/coef:496). You will be redirected to the CILogon sign in page. Select your institution and use your institutional credentials to login. You will use these credentials later to login so it is important to remember the institution you use at this step. +1. To request an OSPool account, visit this account [registration page](https://registry.cilogon.org/registry/co_petitions/start/coef:211). You will be redirected to the CILogon sign in page. Select your institution and use your institutional credentials to login. You will use these credentials later to login so it is important to remember the institution you use at this step. @@ -78,7 +78,7 @@ It is also possible to authenticate using an SSH key pair, if you prefer. Loggin The process below describes how to upload a public key to the registration website. It assumes that a private/public key pair has already been generated. If you need to generate a key pair, see this [OSG guide](../generate-add-sshkey). -1. Return to the [Registration Page](https://registry.cilogon.org/registry/co_petitions/start/coef:211) and login using your institutional credentials if prompted. +1. Return to the [Registration Page](https://registry.cilogon.org/registry/auth/logout) and login using your institutional credentials if prompted. 2. Click your name at the top right. In the dropdown box, click "My Profile (OSG)" button. From c891b0f3cb72686bfe2ebb2cdaa24a6fe758015a Mon Sep 17 00:00:00 2001 From: Christina Koch Date: Wed, 25 Sep 2024 17:07:02 -0500 Subject: [PATCH 2/5] renaming comanage access page --- data/configs/ospool.yml | 2 +- .../overview/account_setup/comanage-access.md | 104 ++++++++++++++++++ 2 files changed, 105 insertions(+), 1 deletion(-) create mode 100644 documentation/overview/account_setup/comanage-access.md diff --git a/data/configs/ospool.yml b/data/configs/ospool.yml index faa0001..34673a6 100644 --- a/data/configs/ospool.yml +++ b/data/configs/ospool.yml @@ -7,7 +7,7 @@ nav: - "Frequently Asked Questions": overview/references/frequently-asked-questions.md - Account Setup: - "Start Here: Overview of Requesting OSPool Access": overview/account_setup/registration-and-login.md - - "Log In to uw.osg-htc.org Access Points": overview/account_setup/ap7-access.md + - "Log In to uw.osg-htc.org Access Points": overview/account_setup/comanage-access.md - "Log In to OSG Connect Access Points": overview/account_setup/connect-access.md - "Generate SSH Keys": overview/account_setup/generate-add-sshkey.md - "Set and View Project Usage": overview/account_setup/starting-project.md diff --git a/documentation/overview/account_setup/comanage-access.md b/documentation/overview/account_setup/comanage-access.md new file mode 100644 index 0000000..e3c1d22 --- /dev/null +++ b/documentation/overview/account_setup/comanage-access.md @@ -0,0 +1,104 @@ +--- +ospool: + path: overview/account_setup/ap7-access.md +--- + +# Log In to `uw.osg-htc.org` Access Points + +**This guide is for users who were notified by a member of the OSG team that they +will be using the `uw.osg-htc.org` Access Points.** + +To join and use the `uw.osg-htc.org` Access Points (`ap40.uw.osg-htc.org`), you will go through the following steps: + +1. Apply for a `uw.osg-htc.org` Access Point account +2. Have your account approved by an OSG Team member +3. Log in to `ap40.uw.osg-htc.org` + +## Request Access to `uw.osg-htc.org` Access Points + +To request access to `ap40.uw.osg-htc.org`, submit an application using the following steps: + +1. To request an OSPool account, visit this account [registration page](https://registry.cilogon.org/registry/co_petitions/start/coef:211). You will be redirected to the CILogon sign in page. Select your institution and use your institutional credentials to login. You will use these credentials later to login so it is important to remember the institution you use at this step. + + + + + + If you have issues signing in using your institutional credentials, contact us at [support@osg-htc.org](mailto:support@osg-htc.org). + + +2. Once you sign in, you will be redirected to the User Enrollment page. Click "Begin" and enter your name and email address in the following page. In many cases, this information will be automatically populated. If desired, it is possible to manually edit any information automatically filled in. Once you have entered your information, click "SUBMIT". + + + + +3. After submitting your application, you will receive an email from [registry@cilogon.org](mailto:registry@cilogon.org) to verify your email address. Click the link listed in the email to be redirected to a page confirm your invitation details. Click the "ACCEPT" button to complete this step. + + + + + +## Account Approval by a Research Computing Facilitator + +If a meeting has not already been scheduled with a Research Computing Facilitator, one of the facilitation team will contact you about arranging a short consultation. + +Following the meeting, the Facilitator will approve your account and add your profile to any relevant OSG ‘project’ names. Once your account is ready, the Facilitator will email you with your account details including the 'username' you will use to log in to the `ap40.uw.osg-htc.org` access point. + +## Log in + +Once your account has been added to the `ap40.uw.osg-htc.org` access point, you will be able to log in using a terminal or SSH program. Logging in requires authenticating your credientials using one of two options: __web authentication__ or __SSH key pair authentication__. Additional information on this process will be provided during and/or following your discussion with a Research Computing Facilitator. + + +### Option 1: Log in via Web Authentication + +Logging in via web authentication requires no preparatory steps beyond having access to an internet browser. + +To authenticate using this approach: + +1. Open a terminal and type `ssh username@ap40.uw.osg-htc.org`, being sure to replace `username` with your `uw.osg-htc.org` username. Upon hitting enter, the following text should appear with a unique, but similar, URL: + + + Authenticate at + ----------------- + https://cilogon.org/device/?user_code=FF4-ZX6-9LK + ----------------- + Type 'Enter' when you authenticate. + + +2. Copy the `https://` link, paste it into a web browser, and hit enter. + +3. You will be redirected to a new page where you will be prompted to login using your institutional credentials. Once you have done so, a new page will appear with the following text: "You have successfully approved the user code. Please return to your device for further instructions." + +4. Return to your terminal, and type 'Enter' to complete the login process. + + +### Option 2: Log in via SSH Key Pair Authentication + +It is also possible to authenticate using an SSH key pair, if you prefer. Logging in using SSH keys does not require access to an internet browser to log in into the OSG Access Point, `ap40.uw.osg-htc.org`. + +The process below describes how to upload a public key to the registration website. It assumes that a private/public key pair has already been generated. If you need to generate a key pair, see this [OSG guide](../generate-add-sshkey). + +1. Return to the [Registration Page](https://registry.cilogon.org/registry/auth/logout) and login using your institutional credentials if prompted. + +2. Click your name at the top right. In the dropdown box, click "My Profile (OSG)" button. + + + +3. On the right hand side of your profile, click "Authenticators" link. + + + +4. On the authenticators page, click the "Manage" button. + + + +5. On the new SSH Keys page, click "Add SSH Key" and browse your computer to upload your public SSH key. + + + +You can now log in to `ap40.uw.osg-htc.org` from the terminal, using `ssh username@ap40.uw.osg-htc.org`. When you log in, instead of being prompted with a web link, you should either authenticate automatically or be asked for your ssh key passphrase to complete logging in. + + +## Get Help + +For questions regarding logging in or creating an account, contact us at [support@osg-htc.org](mailto:support@osg-htc.org). From 6cbd0663e4a27db87a6d97854a0cf2597016a0c1 Mon Sep 17 00:00:00 2001 From: Christina Koch Date: Wed, 25 Sep 2024 17:07:55 -0500 Subject: [PATCH 3/5] change path registration title --- data/configs/path.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/configs/path.yml b/data/configs/path.yml index fd99329..17aa6b5 100644 --- a/data/configs/path.yml +++ b/data/configs/path.yml @@ -3,7 +3,7 @@ nav: - Overview: - Welcome And Account Setup: - "Getting Started": overview/account_setup/getting-started.md - - "Registration": overview/account_setup/registration.md + - "Register for a PATh Facility Account": overview/account_setup/registration.md - "Log in with SSH Keys": overview/account_setup/generate-add-sshkey.md - "Request PATh Facility Credits": overview/account_setup/request-credits.md - References: From 68f3deb3632ec04365d9c85a4ab890347425c4cc Mon Sep 17 00:00:00 2001 From: Christina Koch Date: Wed, 25 Sep 2024 17:10:16 -0500 Subject: [PATCH 4/5] add link to new version of guide --- documentation/overview/account_setup/ap7-access.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/documentation/overview/account_setup/ap7-access.md b/documentation/overview/account_setup/ap7-access.md index e3c1d22..0e30c9a 100644 --- a/documentation/overview/account_setup/ap7-access.md +++ b/documentation/overview/account_setup/ap7-access.md @@ -3,6 +3,8 @@ ospool: path: overview/account_setup/ap7-access.md --- +The latest version of this guide is at [this link](documentation/overview/account_setup/comanage-access/) + # Log In to `uw.osg-htc.org` Access Points **This guide is for users who were notified by a member of the OSG team that they From 86fe18c6eeda5f225910d4c42e76063d79b690a1 Mon Sep 17 00:00:00 2001 From: Cannon Lock Date: Thu, 26 Sep 2024 09:34:34 -0500 Subject: [PATCH 5/5] Patch Fix links Remove obsolete content --- .../overview/account_setup/ap7-access.md | 102 +----------------- .../overview/account_setup/comanage-access.md | 2 +- 2 files changed, 2 insertions(+), 102 deletions(-) diff --git a/documentation/overview/account_setup/ap7-access.md b/documentation/overview/account_setup/ap7-access.md index 0e30c9a..e151292 100644 --- a/documentation/overview/account_setup/ap7-access.md +++ b/documentation/overview/account_setup/ap7-access.md @@ -3,104 +3,4 @@ ospool: path: overview/account_setup/ap7-access.md --- -The latest version of this guide is at [this link](documentation/overview/account_setup/comanage-access/) - -# Log In to `uw.osg-htc.org` Access Points - -**This guide is for users who were notified by a member of the OSG team that they -will be using the `uw.osg-htc.org` Access Points.** - -To join and use the `uw.osg-htc.org` Access Points (`ap40.uw.osg-htc.org`), you will go through the following steps: - -1. Apply for a `uw.osg-htc.org` Access Point account -2. Have your account approved by an OSG Team member -3. Log in to `ap40.uw.osg-htc.org` - -## Request Access to `uw.osg-htc.org` Access Points - -To request access to `ap40.uw.osg-htc.org`, submit an application using the following steps: - -1. To request an OSPool account, visit this account [registration page](https://registry.cilogon.org/registry/co_petitions/start/coef:211). You will be redirected to the CILogon sign in page. Select your institution and use your institutional credentials to login. You will use these credentials later to login so it is important to remember the institution you use at this step. - - - - - - If you have issues signing in using your institutional credentials, contact us at [support@osg-htc.org](mailto:support@osg-htc.org). - - -2. Once you sign in, you will be redirected to the User Enrollment page. Click "Begin" and enter your name and email address in the following page. In many cases, this information will be automatically populated. If desired, it is possible to manually edit any information automatically filled in. Once you have entered your information, click "SUBMIT". - - - - -3. After submitting your application, you will receive an email from [registry@cilogon.org](mailto:registry@cilogon.org) to verify your email address. Click the link listed in the email to be redirected to a page confirm your invitation details. Click the "ACCEPT" button to complete this step. - - - - - -## Account Approval by a Research Computing Facilitator - -If a meeting has not already been scheduled with a Research Computing Facilitator, one of the facilitation team will contact you about arranging a short consultation. - -Following the meeting, the Facilitator will approve your account and add your profile to any relevant OSG ‘project’ names. Once your account is ready, the Facilitator will email you with your account details including the 'username' you will use to log in to the `ap40.uw.osg-htc.org` access point. - -## Log in - -Once your account has been added to the `ap40.uw.osg-htc.org` access point, you will be able to log in using a terminal or SSH program. Logging in requires authenticating your credientials using one of two options: __web authentication__ or __SSH key pair authentication__. Additional information on this process will be provided during and/or following your discussion with a Research Computing Facilitator. - - -### Option 1: Log in via Web Authentication - -Logging in via web authentication requires no preparatory steps beyond having access to an internet browser. - -To authenticate using this approach: - -1. Open a terminal and type `ssh username@ap40.uw.osg-htc.org`, being sure to replace `username` with your `uw.osg-htc.org` username. Upon hitting enter, the following text should appear with a unique, but similar, URL: - - - Authenticate at - ----------------- - https://cilogon.org/device/?user_code=FF4-ZX6-9LK - ----------------- - Type 'Enter' when you authenticate. - - -2. Copy the `https://` link, paste it into a web browser, and hit enter. - -3. You will be redirected to a new page where you will be prompted to login using your institutional credentials. Once you have done so, a new page will appear with the following text: "You have successfully approved the user code. Please return to your device for further instructions." - -4. Return to your terminal, and type 'Enter' to complete the login process. - - -### Option 2: Log in via SSH Key Pair Authentication - -It is also possible to authenticate using an SSH key pair, if you prefer. Logging in using SSH keys does not require access to an internet browser to log in into the OSG Access Point, `ap40.uw.osg-htc.org`. - -The process below describes how to upload a public key to the registration website. It assumes that a private/public key pair has already been generated. If you need to generate a key pair, see this [OSG guide](../generate-add-sshkey). - -1. Return to the [Registration Page](https://registry.cilogon.org/registry/auth/logout) and login using your institutional credentials if prompted. - -2. Click your name at the top right. In the dropdown box, click "My Profile (OSG)" button. - - - -3. On the right hand side of your profile, click "Authenticators" link. - - - -4. On the authenticators page, click the "Manage" button. - - - -5. On the new SSH Keys page, click "Add SSH Key" and browse your computer to upload your public SSH key. - - - -You can now log in to `ap40.uw.osg-htc.org` from the terminal, using `ssh username@ap40.uw.osg-htc.org`. When you log in, instead of being prompted with a web link, you should either authenticate automatically or be asked for your ssh key passphrase to complete logging in. - - -## Get Help - -For questions regarding logging in or creating an account, contact us at [support@osg-htc.org](mailto:support@osg-htc.org). +The latest version of this guide is at [this link](/documentation/overview/account_setup/comanage-access/) diff --git a/documentation/overview/account_setup/comanage-access.md b/documentation/overview/account_setup/comanage-access.md index e3c1d22..663ed46 100644 --- a/documentation/overview/account_setup/comanage-access.md +++ b/documentation/overview/account_setup/comanage-access.md @@ -1,6 +1,6 @@ --- ospool: - path: overview/account_setup/ap7-access.md + path: overview/account_setup/comanage-access.md --- # Log In to `uw.osg-htc.org` Access Points