new stuff for the site; new keychain project page

author: Daniel Robbins <drobbins@gentoo.org> 2001-08-21 21:03:27 +0000
committer: Daniel Robbins <drobbins@gentoo.org> 2001-08-21 21:03:27 +0000
commit: ecea2267244feeee83681681e0b73427687de775 (patch)
tree: 76f16ecc105d6d68d4ccb07de331925f1d0c1059 /app-doc
parent: digests (diff)
download: historical-ecea2267244feeee83681681e0b73427687de775.tar.gz
historical-ecea2267244feeee83681681e0b73427687de775.tar.bz2
historical-ecea2267244feeee83681681e0b73427687de775.zip
4 files changed, 124 insertions, 13 deletions
diff --git a/app-doc/gentoo-web/files/images/keychain-2.gif b/app-doc/gentoo-web/files/images/keychain-2.gif
new file mode 100644
index 000000000000..49f0788aa642
--- /dev/null
+++ b/app-doc/gentoo-web/files/images/keychain-2.gif
diff --git a/app-doc/gentoo-web/files/xml/keychain.xml b/app-doc/gentoo-web/files/xml/keychain.xml
new file mode 100644
index 000000000000..7cfa1581df44
--- /dev/null
+++ b/app-doc/gentoo-web/files/xml/keychain.xml
@@ -0,0 +1,89 @@
+<?xml version='1.0'?>
+<guide type="project" link="/projects/keychain.html">
+<title>Keychain</title>
+<author title="Author"><mail link="drobbins@gentoo.org">Daniel Robbins</mail></author>
+
+<abstract>
+This page contains information about Keychain, an OpenSSH-compatible RSA/DSA key management
+application for bash.
+</abstract>
+
+<version>1.0</version>
+<date>21 Aug 2001</date>
+
+<chapter>
+<title>Keychain Intro</title>
+<section>
+<body>
+<p>
+Many of us use the excellent <uri
+link="http://www.openssh.com">OpenSSH</uri> as a secure, encrypted replacement
+for the venerable telnet and rsh commands.  One of OpenSSH's more intriguing
+features is its ability to authenticate users using the RSA and DSA
+authentication protocols, which are based upon a pair of complementary
+numerical "keys".  And one of the main appeals of RSA and DSA authentication is the
+promise of being able to establish connections to remote systems <e>without
+supplying a password</e>.  The <c>keychain</c> bash script makes handling RSA and
+DSA keys both convenient and secure.  It acts as a front-end to <c>ssh-agent</c>,
+but allows you to easily have one long-running <c>ssh-agent</c> process <e>per system</e>,
+rather than per login session.  This dramatically reduces the number of times you need
+to enter your passphrase from once per new login session to once <e>every time your local
+machine is rebooted.</e>
+</p>
+</body>
+</section>
+</chapter>
+<chapter>
+<title>The screenshot</title>
+<section>
+<body>
+<figure link="/images/keychain-2.gif" caption="Keychain in action"/>
+
+<p>Above, <c>drobbins</c> logs in to <c>cvs.gentoo.org</c>, and <c>keychain</c>
+(called from <path>~/.bash_profile</path>) starts up.  <c>keychain</c> detects
+a long-running <c>ssh-agent</c> process that already holds <c>drobbins</c>'
+private keys and configures the shell environment appropriately.  Because
+<c>keychain</c> "hooks in" to an existing <c>ssh-agent</c> process,
+<c>drobbins</c> gains access to his keys without typing in his
+passphrases, even though he just opened a brand new login session.  He can now
+establish secure passwordless connections with any host configured to recognize
+these keys.  In fact, <c>drobbins</c> will only need to enter his
+passphrases again after <c>cvs.gentoo.org</c> is rebooted.  That's the only
+time you really need to reinitialize the long-running <c>ssh-agent</c> process.
+</p>
+</body>
+</section>
+</chapter>
+<chapter>
+<title>The IBM developerWorks articles</title>
+<section>
+<body>
+
+<p><c>keychain</c> was first introduced in a series of <uri
+link="http://www.ibm.com/developerworks">IBM developerWorks</uri> articles.
+<b><uri link="http://www-106.ibm.com/developerworks/library/l-keyc.html">The first
+keychain article</uri></b> introduces the concepts behind RSA/DSA key
+authentication and shows you how to set up primitive (with passphrase) RSA/DSA
+authentication, while the <b>second article</b> (<e>coming soon!</e>) shows you how to
+use <c>keychain</c> to set up secure, <e>passwordless</e> <c>ssh</c> access in an
+extremely convenient way.  <c>keychain</c> also provides a clean, secure way for
+<c>cron</c> jobs to take advantage of RSA/DSA keys without having to use insecure
+unencrypted private keys.
+</p>
+</body>
+</section>
+</chapter>
+<chapter>
+<title>The source</title>
+<section>
+<body>
+
+<p>
+The most recent release of <c>keychain</c> can be found here:<br/><br/>
+<uri>http://www.ibiblio.org/gentoo/distfiles/keychain-1.0.tar.bz2</uri>
+</p>
+</body>
+</section>
+</chapter>
+</guide>
+
diff --git a/app-doc/gentoo-web/files/xml/main-news.xml b/app-doc/gentoo-web/files/xml/main-news.xml
index f5d3e419afe4..40b1ec41f784 100644
--- a/app-doc/gentoo-web/files/xml/main-news.xml
+++ b/app-doc/gentoo-web/files/xml/main-news.xml
@@ -4,11 +4,28 @@
 <author title="Author"><mail link="drobbins@gentoo.org">Daniel Robbins</mail></author>
 
 <version>1.0.3</version>
-<date>16 Aug 2001</date>
+<date>21 Aug 2001</date>
 
 <newsitems>
 	<news align="left" graphic="/images/icon-linux.png">
 		<poster>drobbins</poster>
+		<date>21 Aug 2001</date>
+		<title>Keychain, Hackfest/Development update</title>
+		<body>
+		<p><b>I've now added a <uri link="/projects/keychain">Keychain</uri> project page to the site</b>.  For those who don't
+		know, <c>keychain</c> is a special <uri link="http://www.openssh.com">OpenSSH</uri>-compatible key management app
+		that interfaces with <c>ssh-agent</c> and makes it possible to set up secure connections easily and conveniently
+		-- without typing in a passphrase every time.  The second part of my RSA/DSA authentication article will appear soon
+		on <uri link="http://www.ibm.com/developerworks/linux">IBM developerWorks</uri>.  In the mean time, you may want to check out <uri link="http://www-106.ibm.com/developerworks/library/l-keyc.html">my first RSA/DSA article</uri>, which covers
+		OpenSSH RSA/DSA key-based authentication basics.</p>
+		<p><b>Also, the Hackfest was a big success!</b>  Tons of bugs were stomped, and we now have the second revision of
+		our experimental Gentoo Linux 1.0_rc6 build image (with <e>glibc 2.2.4</e>) so that developers can continue their testing.  Revision three should
+		be out in the next few days and should contain <e>kernel 2.4.8-rc6+</e>.  Along the way, we continue to wipe out huge numbers of bugs, and Gentoo Linux 1.0_rc6 certainly looks like it's going to be the most refined version of Gentoo Linux yet.
+		</p>
+		</body>
+	</news>
+	<news align="right" graphic="/images/icon-linux.png">
+		<poster>drobbins</poster>
 		<date>16 Aug 2001</date>
 		<title>New IBM dW tutorial, Hackfest, LWN</title>
 		<body>
@@ -18,7 +35,7 @@
 		<p>And third, <b>a new issue of <uri link="http://www.lwn.net">the Linux Weekly News</uri> is now online</b>.  I'm a big fan of LWN, and if you want to keep up with what is going on in the Linux world, it's always a good idea to head over to <uri>http://www.lwn.net</uri> every Thursday and give it a read.</p>
 		</body>
 	</news>
-<news align="right" graphic="/images/icon-stick1.png">
+<news align="left" graphic="/images/icon-stick1.png">
 		<poster>drobbins</poster>
 		<date>14 Aug 2001</date>
 		<title>Web site updates</title>
@@ -55,7 +72,7 @@ Right now, the XML component of the news system is complete, and Thread (dev-wik
 		</p>
 		</body>
 	</news>
-	<news align="left" graphic="/images/icon-clock.png">
+	<news align="right" graphic="/images/icon-clock.png">
 		<poster>drobbins</poster>
 		<date>14 Aug 2001</date>
 		<title>Gentoo Linux 1.0_rc6 status update</title>
diff --git a/app-doc/gentoo-web/gentoo-web-2.2.ebuild b/app-doc/gentoo-web/gentoo-web-2.2.ebuild
index fa531675407f..8e2ad29fe9f2 100644
--- a/app-doc/gentoo-web/gentoo-web-2.2.ebuild
+++ b/app-doc/gentoo-web/gentoo-web-2.2.ebuild
@@ -1,7 +1,7 @@
 # Copyright 1999-2001 Gentoo Technologies, Inc. Distributed under the terms
 # of the GNU General Public License, v2 or later 
 # Author Daniel Robbins <drobbins@gentoo.org>
-# $Header: /var/cvsroot/gentoo-x86/app-doc/gentoo-web/gentoo-web-2.2.ebuild,v 1.14 2001/08/15 07:26:08 drobbins Exp $
+# $Header: /var/cvsroot/gentoo-x86/app-doc/gentoo-web/gentoo-web-2.2.ebuild,v 1.15 2001/08/21 21:03:24 drobbins Exp $
  
 S=${WORKDIR}/${P}
 DESCRIPTION="www.gentoo.org website"
@@ -26,18 +26,23 @@ src_install() {
 	for x in build desktop xml-guide portage-user gentoo-howto faq nvidia_tsg openafs
 	# (9/13/2001) cvs-tutorial
 	do
-		xsltproc xsl/guide-main.xsl xml/${x}.xml > ${D}/usr/local/httpd/htdocs/doc/${x}.html
+		xsltproc xsl/guide-main.xsl xml/${x}.xml > ${D}/usr/local/httpd/htdocs/doc/${x}.html || die
 	done
 	dodir /usr/local/httpd/htdocs/images
 	insinto /usr/local/httpd/htdocs/images
 	cd ${FILESDIR}/images
-	doins gtop-s.jpg gbot-s.gif gridtest.gif gentoo-new.gif install*.gif fishhead.gif line.gif icon-*
+	doins gtop-s.jpg gbot-s.gif gridtest.gif gentoo-new.gif install*.gif fishhead.gif line.gif icon-* keychain-2.gif
 	insinto /usr/local/httpd/htdocs
 	doins favicon.ico
 	#dynamic firewalls tools page
 	cd ${FILESDIR}
-	xsltproc xsl/guide-main.xsl xml/dynfw.xml > ${D}/usr/local/httpd/htdocs/projects/dynfw.html	
-	xsltproc xsl/guide-main.xsl xml/project-xml.xml > ${D}/usr/local/httpd/htdocs/projects/xml.html	
+	xsltproc xsl/guide-main.xsl xml/dynfw.xml > ${D}/usr/local/httpd/htdocs/projects/dynfw.html	|| die
+	xsltproc xsl/guide-main.xsl xml/project-xml.xml > ${D}/usr/local/httpd/htdocs/projects/xml.html	|| die
+	
+	#both URLs should work
+	dodir /usr/local/httpd/htdocs/projects/keychain
+	xsltproc xsl/guide-main.xsl xml/keychain.xml > ${D}/usr/local/httpd/htdocs/projects/keychain.html || die	
+	xsltproc xsl/guide-main.xsl xml/keychain.xml > ${D}/usr/local/httpd/htdocs/projects/keychain/index.html	|| die
 	
 	insinto /usr/local/httpd/htdocs/projects
 	doins dynfw/dynfw-1.0.1.tar.gz 
@@ -48,11 +53,11 @@ src_install() {
 	
 	insinto /usr/local/httpd/htdocs
 
-	xsltproc xsl/guide-main.xsl xml/main-news.xml > ${D}/usr/local/httpd/htdocs/index.html
-	xsltproc xsl/guide-main.xsl xml/main-about.xml > ${D}/usr/local/httpd/htdocs/index-about.html
-	xsltproc xsl/guide-main.xsl xml/main-download.xml > ${D}/usr/local/httpd/htdocs/index-download.html
-	xsltproc xsl/guide-main.xsl xml/main-projects.xml > ${D}/usr/local/httpd/htdocs/index-projects.html
-		
+	xsltproc xsl/guide-main.xsl xml/main-news.xml > ${D}/usr/local/httpd/htdocs/index.html || die
+	xsltproc xsl/guide-main.xsl xml/main-about.xml > ${D}/usr/local/httpd/htdocs/index-about.html || die
+	xsltproc xsl/guide-main.xsl xml/main-download.xml > ${D}/usr/local/httpd/htdocs/index-download.html || die
+	xsltproc xsl/guide-main.xsl xml/main-projects.xml > ${D}/usr/local/httpd/htdocs/index-projects.html || die
+
 	doins css/main-new.css
 	
 	#install XSL for later use
author	Daniel Robbins <drobbins@gentoo.org>	2001-08-21 21:03:27 +0000
committer	Daniel Robbins <drobbins@gentoo.org>	2001-08-21 21:03:27 +0000
commit	ecea2267244feeee83681681e0b73427687de775 (patch)
tree	76f16ecc105d6d68d4ccb07de331925f1d0c1059 /app-doc
parent	digests (diff)
download	historical-ecea2267244feeee83681681e0b73427687de775.tar.gz historical-ecea2267244feeee83681681e0b73427687de775.tar.bz2 historical-ecea2267244feeee83681681e0b73427687de775.zip