OCIO » CVS & SVN Key Based Auth Setup

Changes for document CVS & SVN Key Based Auth Setup

Last modified by Matthew Harshbarger on 2016/01/07 09:01
From version 10.1
edited by Matthew Harshbarger
on 2016/01/07 09:01
To version 11.1
edited by Matthew Harshbarger
on 2016/01/07 09:01
Change comment: There is no comment for this version
Metadata changes
Property Previous value New value
Title CVS & SVN Key Based Auth Setup
Parent OCIO.WebHome
Content changes
CVS & SVN Key Based Auth Setup
(% style="BORDER-TOP: medium none; BORDER-RIGHT: medium none; BORDER-BOTTOM: #4f81bd 1pt solid; PADDING-BOTTOM: 4pt; PADDING-TOP: 0in; PADDING-LEFT: 0in; BORDER-LEFT: medium none; PADDING-RIGHT: 0in; mso-element: para-border-div; mso-border-bottom-themecolor: accent1" %)
(((
(% class="MsoTitle" style="MARGIN: 0in 0in 15pt" %)
(% style="font-size: 1.8em; color: rgb(23, 54, 93); font-family: Cambria" %)Key Based Authentication, OCIO GForge
)))
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="font-family: Calibri; font-size: 1em; color: rgb(0, 0, 0)" %)This guide explains the process of setting up key based authentication for access to OCIO hosted SVN and CVS repositories.
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="font-family: Calibri; font-size: 1em; color: rgb(0, 0, 0)" %)Tools you will need:
(% class="MsoListParagraphCxSpFirst" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Putty
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); BACKGROUND: white; COLOR: black; font-family: Calibri; font-size: 1em" %)PuTTYgen
(% class="MsoListParagraphCxSpLast" style="MARGIN: 0in 0in 10pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); BACKGROUND: white; COLOR: black; font-family: Calibri; font-size: 1em" %)Plink
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="BACKGROUND: white; COLOR: black; font-size: 1em; font-family: Calibri" %)PuTTY is a free implementation of Telnet and SSH for Windows and Unix platforms, along with an(% class="apple-converted-space" %) (% style="FONT-SIZE: 10pt; BACKGROUND: white; COLOR: black; LINE-HEIGHT: 115%; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin" %)xterm(% class="apple-converted-space" style="font-size: 1em; font-family: Calibri; BACKGROUND: white; COLOR: black" %) (% style="font-size: 1em; font-family: Calibri; BACKGROUND: white; COLOR: black; BACKGROUND: white; COLOR: black" %)terminal emulator. (% style="color:#000000;font-family:Calibri;font-size:1.0em;" %)At the time this document was published these tools were available here:
[[(% style="color:#0000ff;font-family:Calibri;font-size:1.0em;" %)__http:~~/~~/www.chiark.greenend.org.uk/~~~~sgtatham/putty/download.html__>>http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]]
(% style="MARGIN: 10pt 0in 0pt" %)
== (% style="font-size: 1.2em; color: rgb(79, 129, 189); font-family: Cambria" %)**Step One**(%%) ==
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="font-size: 1em; color: rgb(0, 0, 0); font-family: Calibri" %)Download the tools described above, and put them somewhere you will remember, such as C:\putty\
(% style="MARGIN: 10pt 0in 0pt" %)
== (% style="font-size: 1.2em; color: rgb(79, 129, 189); font-family: Cambria" %)**Step Two**(%%) ==
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="font-size: 1em; font-family: Calibri; color: rgb(0, 0, 0)" %)Run PuTTYgen.exe, this tool generates public and private keys. You will save your PUBLIC key to your GForge account, and store your private key somewhere safe on the PC you are connecting from. This private key identifies you instead of using a password, so be sure it is stored somewhere safe and not published or shared with others.
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="font-size: 1em; font-family: Calibri; color: rgb(0, 0, 0)" %)Run PuTTYgen.exe:
(% class="MsoListParagraphCxSpFirst" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l5 level1 lfo2" %)
(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em" %)1)(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri" %)Ensure SSH2-RSA is selected as the type of key you are generating.
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l5 level1 lfo2" %)
(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em" %)2)(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri" %)Ensure 2048 is set for the number of bits in the generated key.
(% class="MsoListParagraphCxSpLast" style="MARGIN: 0in 0in 10pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l5 level1 lfo2" %)
(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em" %)3)(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri" %)Click “Generate”, and move the mouse randomly in the blank space to seed the generator with random data.
(% style="FONT-SIZE: 11pt; FONT-FAMILY: 'Calibri','sans-serif'; LINE-HEIGHT: 115%; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA" %)[[image:PuTTYKeyGenerator.bmp||style="FLOAT: right"]]
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="FONT-SIZE: 13pt; FONT-FAMILY: 'Cambria','serif'; COLOR: #4f81bd; LINE-HEIGHT: 115%; mso-ascii-theme-font: major-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: major-fareast; mso-hansi-theme-font: major-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: major-bidi; mso-themecolor: accent1" %)** **
(% style="MARGIN: 10pt 0in 0pt" %)
== (% style="font-size: 1.2em; color: rgb(79, 129, 189); font-family: Cambria" %)**Step Three**(%%) ==
(% class="MsoListParagraph" style="MARGIN: 0in 0in 10pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l4 level1 lfo4" %)
(% style="FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; color: rgb(0, 0, 0); font-size: 1em" %)·(% style="FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; color: rgb(0, 0, 0); font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (%%)
(% style="font-size: 1em; color: rgb(0, 0, 0); font-family: Calibri" %)Now that you’ve generated your keys, copy the “public key for pasting” to a new notepad document and save it somewhere you will remember.
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="color:#000000;font-family:Calibri;font-size:1.0em;" %) [[image:PuTTYKeyGenerator2.bmp]]
(% style="MARGIN: 10pt 0in 0pt" %)
== (% style="font-size: 1.2em; color: rgb(79, 129, 189); font-family: Cambria" %)**Step Four**(%%) ==
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="font-family: Calibri; font-size: 1em; color: rgb(0, 0, 0)" %)In this step you will save your private key for future use.
(% class="MsoListParagraphCxSpFirst" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l3 level1 lfo3" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri" %)Click “Save private key” to save your private key, save this private key somewhere safe and do not share it with others as it acts as your password.
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 1in; TEXT-INDENT: -0.25in; mso-add-space: auto; mso-list: l3 level2 lfo3" %)
(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em" %)a.(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri; mso-spacerun: yes" %) (% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri" %)If you want, you can put a password on the private key by entering it “Key passphrase” field.
(% class="MsoListParagraphCxSpLast" style="MARGIN: 0in 0in 10pt 1in; TEXT-INDENT: -0.25in; mso-add-space: auto; mso-list: l3 level2 lfo3" %)
(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em" %)b.(% style="color: rgb(0, 0, 0); mso-bidi-font-family: Calibri; mso-bidi-theme-font: minor-latin; mso-list: Ignore; font-family: Calibri; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri" %)If you want, save your public key as well by clicking “Save public key”, however you will be using the public key you pasted into notepad for GForge.
(% style="MARGIN: 10pt 0in 0pt" %)
== (% style="font-size: 1.2em; color: rgb(79, 129, 189); font-family: Cambria" %)**Step Five**(%%) ==
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="font-family: Calibri; font-size: 1em; color: rgb(0, 0, 0)" %)In this step you will store your public key in GForge by accessing the GForge website and updating your account’s settings.
(% class="MsoListParagraphCxSpFirst" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Open the notepad file containing the key you saved in **Step Three**
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Logon to the GForge website at [[(% style="color:#0000ff;font-family:Calibri;font-size:1.0em;" %)__https:~~/~~/forge.iowa.gov/gf/__>>https://forge.iowa.gov/gf/]]
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Click the “My Stuff” tab at the top after logging in.
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Click the “My Account” menu item in the left side nav.
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Click the “Edit SSH Keys” submenu in the left side nav.
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Scroll down/locate the text area on this page, and paste your key from notepad here.
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Enter the password you used to logon to the forge website again, and then click “Submit Keys”
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; color: rgb(0, 0, 0); font-size: 1em" %)·(% style="FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; color: rgb(0, 0, 0); font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="font-family: Calibri; font-size: 1em; color: rgb(0, 0, 0)" %)Confirm you receive the message “Your keys have been successfully saved”.
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)**Make a note of your system username, it is shown at the top of the left nav, in the screenshot to the right you can see my username is “justincarlson”.**
(% class="MsoListParagraphCxSpLast" style="MARGIN: 0in 0in 10pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l2 level1 lfo1" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri" %)You may now close the forge website.
(% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri" %)[[image:PuTTYKeyGenerator3.bmp]]
(% style="MARGIN: 10pt 0in 0pt" %)
== (% style="font-size: 1.2em; color: rgb(79, 129, 189); font-family: Cambria" %)**Step Six**(%%) ==
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="font-family: Calibri; font-size: 1em; color: rgb(0, 0, 0)" %)Now that you’ve successfully saved your keys and set your public key in GForge, you’ll need to setup a connection in putty to use these keys.
(% class="MsoListParagraphCxSpFirst" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l0 level1 lfo5" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Run putty.exe from the location you moved it to in **Step One**
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l0 level1 lfo5" %)
(% style="FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; color: rgb(0, 0, 0); font-size: 1em" %)·(% style="FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; color: rgb(0, 0, 0); font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="font-family: Calibri; font-size: 1em; color: rgb(0, 0, 0)" %)Enter scm.forge.iowa.gov in the Host Name and Saved Session fields:
\\[[image:PuTTYKeyGenerator4.bmp]]
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l0 level1 lfo5" %)
(% style="FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; color: rgb(0, 0, 0); font-size: 1em" %)·(% style="FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; color: rgb(0, 0, 0); font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color:#000000;font-family:Calibri;font-size:1.0em;" %)Do not save yet, in the tree menu to the left, expand SSH and then click AUTH:
\\[[image:PuTTYKeyGenerator5.bmp]]
\\Click Browse next to the “Private key file” field and locate your PRIVATE key saved from **Step Four **above. After you’ve selected your private key, scroll back up in the menu to the left and select “Session”, then click the Save button:(% style="font-size: 1em; color: rgb(0, 0, 0); font-family: Calibri; mso-no-proof: yes" %)
\\After you’ve clicked **Save**(% style="font-size: 1em; color: rgb(0, 0, 0); font-family: Calibri" %), click the **Open** button on the bottom of the window, and enter the username you noted from **Step Four** above when prompted. The putty window should close immediately. If you get a message that your key was rejected, wait 30 minutes and try again as it can take some time for GForge to grant access.
(% class="MsoListParagraphCxSpLast" style="MARGIN: 0in 0in 10pt 0.5in" %)
(% style="color:#000000;font-family:Calibri;font-size:1.0em;" %) [[image:PuTTYKeyGenerator6.bmp]]
(% style="MARGIN: 10pt 0in 0pt" %)
== (% style="font-size: 1.2em; color: rgb(79, 129, 189); font-family: Cambria" %)**Step Seven**(%%) ==
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Your computer is now setup to use PUB/PRIVATE keys to authenticate for any SVN or CVS client that uses plink. We normally use TortoiseSVN or TortoiseCVS, some other clients may have built in configuration options to use the same private key.
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)When using a SVN or CVS client that uses plink, plink is able to recognize the putty entry for scm.forge.iowa.gov and grant access using the keys you’ve just step.
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Lets check out a project to see if it is working.
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="color:#000000;font-family:Calibri;font-size:1.0em;" %)Navigate to a project you have access to on the GForge website:
[[(% style="color:#0000ff;font-family:Calibri;font-size:1.0em;" %)__https:~~/~~/forge.iowa.gov/__>>https://forge.iowa.gov/]]
(% class="MsoListParagraphCxSpFirst" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l1 level1 lfo6" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Logon
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l1 level1 lfo6" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Click “My Stuff”
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l1 level1 lfo6" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Click the “Projects” tab in the middle of the “My Stuff” screen.
(% class="MsoListParagraphCxSpMiddle" style="MARGIN: 0in 0in 0pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l1 level1 lfo6" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em" %)Choose a project you’d like to use as an example.
(% class="MsoListParagraphCxSpLast" style="MARGIN: 0in 0in 10pt 0.5in; TEXT-INDENT: -0.25in; mso-list: l1 level1 lfo6" %)
(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em" %)·(% style="color: rgb(0, 0, 0); FONT-FAMILY: Symbol; mso-fareast-font-family: Symbol; mso-bidi-font-family: Symbol; mso-list: Ignore; font-size: 1em; FONT: 7pt ~"Times New Roman~"" %) (% style="color: rgb(0, 0, 0); font-size: 1em; font-family: Calibri" %)In the Left Nav, click “CVS” or “SVN” and then click “Access Info”, this provides the checkout command including your username:
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
[[image:PuTTYKeyGenerator7.bmp]]
(% style="color:#000000;font-family:Calibri;font-size:1.0em;" %)You can select the access string and then paste it in your CVS or SVN client to check out code:
\\SVN Example:(% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em; mso-spacerun: yes" %) (% style="color: rgb(0, 0, 0); font-family: Calibri; font-size: 1em; mso-tab-count: 1" %) (% style="color:#000000;font-family:Calibri;font-size:1.0em;" %)svn+ssh:~/~/justincarlson@scm.forge.iowa.gov/svnroot/(% style="font-size: 1em; font-family: Calibri; color: rgb(0, 0, 0)" %)**yourprojectnamehere
**CVS Example:(% style="font-size: 1em; font-family: Calibri; color: rgb(0, 0, 0); mso-tab-count: 1" %) (% style="font-size: 1em; font-family: Calibri; color: rgb(0, 0, 0)" %):ext:justincarlson@scm.forge.iowa.gov:/cvsroot/**yourprojectnamehere**
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="font-size: 1em; font-family: Calibri; color: rgb(0, 0, 0)" %)This access string is the “CVSROOT” or “Url of Repository” you’ll use in your CVS or SVN client.
\\**If you’ve followed each step of this guide, you should now be able to checkout and commit code without needing to enter your password several times during the process.**
(% class="MsoNormal" style="MARGIN: 0in 0in 10pt" %)
(% style="color:#000000;font-family:Calibri;font-size:1.0em;" %)If you need further assistance, please contact the OCIO Service Desk at:
(% style="color: rgb(0, 0, 0); FONT-SIZE: 10pt; FONT-FAMILY: ~"Times New Roman','serif~"; LINE-HEIGHT: 115%" %)515-281-5703 phone
800-532-1174 toll free(%%)

This wiki is licensed under a Creative Commons 2.0 license
XWiki Enterprise 3.0.36132 - Documentation