177 lines
4.8 KiB
Plaintext
177 lines
4.8 KiB
Plaintext
|
/***********************************************************************
|
||
|
|
* File: README
|
||
|
|
*
|
||
|
|
* Copyright (C) 2004 Novell, Inc.
|
||
|
|
*
|
||
|
|
* This library is free software; you can redistribute it and/or
|
||
|
|
* modify it under the terms of the GNU General Public
|
||
|
|
* License as published by the Free Software Foundation; either
|
||
|
|
* version 2 of the License, or (at your option) any later version.
|
||
|
|
*
|
||
|
|
* This library is distributed in the hope that it will be useful,
|
||
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
|
|
* Library General Public License for more details.
|
||
|
|
*
|
||
|
|
* You should have received a copy of the GNU General Public
|
||
|
|
* License along with this library; if not, write to the Free
|
||
|
|
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||
|
|
***********************************************************************/
|
||
|
|
|
||
|
|
INTRODUCTION
|
||
|
|
|
||
|
|
The LoginCapture provides a service that exports the credentials used
|
||
|
|
by the user to login to the desktop to the SecretStore wallet. Once in the
|
||
|
|
SecretStore wallet, the credentials can be leveraged by desktop applications
|
||
|
|
to provide a better single sign-on experience to the user.
|
||
|
|
|
||
|
|
Please note that the better single sign-on experience will only be realized if
|
||
|
|
the credentials used to log to the back-end systems match the credentials
|
||
|
|
used to login to the desktop.
|
||
|
|
|
||
|
|
FEATURES
|
||
|
|
|
||
|
|
The LoginCapture services are provided by components that are platform dependent.
|
||
|
|
|
||
|
|
On Linux, LoginCapture provides its services through the use of a PAM module which
|
||
|
|
is inserted into the PAM configuration chain of the default Windows Manager during
|
||
|
|
the installation of the LoginCapture rpm.
|
||
|
|
|
||
|
|
On Windows2000 and above, LoginCapture provides its services through a Credential Manager.
|
||
|
|
|
||
|
|
CONTENTS
|
||
|
|
|
||
|
|
linux - This folder contains the Linux PAM module implementation.
|
||
|
|
|
||
|
|
windows - This folder contanins the Windows Credential Manager implementation.
|
||
|
|
|
||
|
|
package - This folder contains the files necessary to build the software packages
|
||
|
|
under windows and under linux.
|
||
|
|
|
||
|
|
REQUIREMENTS FOR BUILDING THE SOFTWARE PACKAGE ON WINDOWS
|
||
|
|
|
||
|
|
- Install Visual Studio .NET 2003
|
||
|
|
- Install Cygwin - See instructions below.
|
||
|
|
|
||
|
|
Download and start cygwin install:
|
||
|
|
Browse to http://sources.redhat.com/cygwin/
|
||
|
|
|
||
|
|
Click on "Install or update now!" or "Install Cygwin now"
|
||
|
|
|
||
|
|
Cygwin Setup:
|
||
|
|
Next
|
||
|
|
|
||
|
|
Cygwin Setup - Choose Installation Type:
|
||
|
|
Install from Internet
|
||
|
|
Next
|
||
|
|
|
||
|
|
Cygwin Setup - Choose Installation Directory:
|
||
|
|
Root Directory: C:\cygwin
|
||
|
|
Install For: "All Users"
|
||
|
|
|
||
|
|
Default Text File Type: DOS
|
||
|
|
|
||
|
|
Cygwin Setup - Select Local Package Directory:
|
||
|
|
Local Package Directory: C:\cygwin-packages
|
||
|
|
|
||
|
|
Cygwin Setup - Select Connection Type:
|
||
|
|
Direct Connection
|
||
|
|
|
||
|
|
Choose A Download Site:
|
||
|
|
ftp://ftp.nas.nasa.gov
|
||
|
|
|
||
|
|
Cywin Setup - Select Packages:
|
||
|
|
Base:
|
||
|
|
defaults
|
||
|
|
|
||
|
|
Devel:
|
||
|
|
autoconf
|
||
|
|
automake
|
||
|
|
libtool
|
||
|
|
make
|
||
|
|
pkgconfig
|
||
|
|
cvs
|
||
|
|
gcc
|
||
|
|
gcc-g++
|
||
|
|
|
||
|
|
Editors:
|
||
|
|
vim (optional)
|
||
|
|
|
||
|
|
Net:
|
||
|
|
openssh
|
||
|
|
openssl
|
||
|
|
|
||
|
|
Text:
|
||
|
|
more
|
||
|
|
|
||
|
|
Utils:
|
||
|
|
clear (optional)
|
||
|
|
|
||
|
|
Cygwin Setup - Create Icons:
|
||
|
|
Finish
|
||
|
|
|
||
|
|
Edit cygwin.bat (c:\cygwin\cygwin.bat) to add a call to
|
||
|
|
%VS71COMNTOOLS%\vsvars32.bat (see example below). This sets up the
|
||
|
|
Visual Studio tools in Cygwin.
|
||
|
|
|
||
|
|
Sample cygwin.bat:
|
||
|
|
|
||
|
|
@echo off
|
||
|
|
|
||
|
|
call "%VS71COMNTOOLS%\vsvars32.bat" > NUL
|
||
|
|
|
||
|
|
C:
|
||
|
|
chdir C:\cygwin\bin
|
||
|
|
|
||
|
|
bash --login -i
|
||
|
|
|
||
|
|
|
||
|
|
REQUIREMENTS FOR BUILDING THE SOFTWARE PACKAGE ON LINUX
|
||
|
|
|
||
|
|
Install latest mono and mono-devel RPM - Obtain RPMs from
|
||
|
|
www.go-mono.org.
|
||
|
|
|
||
|
|
|
||
|
|
BUILDING THE SOFTWARE PACKAGE
|
||
|
|
|
||
|
|
Windows: Start at Step 1.
|
||
|
|
Linux: Skip to Step 2.
|
||
|
|
|
||
|
|
1. Run cygwin.bat to start up Cygwin.
|
||
|
|
|
||
|
|
2. Generate autotools files:
|
||
|
|
./autogen.sh --prefix=/<install_dir> [--enable-debug]
|
||
|
|
(<install_dir> is some writable directory where 'make install' will
|
||
|
|
install files for testing.
|
||
|
|
|
||
|
|
3. To reconfigure later, or to configure software that came from a source
|
||
|
|
distribution (.tar.gz) file, use configure.
|
||
|
|
./configure --prefix/<install_dir> [--enable-debug]
|
||
|
|
(run ./configure --help for more options)
|
||
|
|
|
||
|
|
4. Select your make target, here are a few interesting ones:
|
||
|
|
|
||
|
|
make [all] - build product files (package files not included)
|
||
|
|
|
||
|
|
make clean - clean up files built by 'make all'
|
||
|
|
|
||
|
|
make package - build product and package files
|
||
|
|
|
||
|
|
make package-clean - clean up package files
|
||
|
|
|
||
|
|
make install - install product files to <install_dir> specified by
|
||
|
|
--prefix during configure
|
||
|
|
|
||
|
|
make uninstall - undo 'make install'
|
||
|
|
|
||
|
|
make dist - build a source distribution tarball.
|
||
|
|
|
||
|
|
make distclean - removes files to return state back to same as the
|
||
|
|
source distribution (configure, Makefile.in files, and other distributed
|
||
|
|
autotools files are not removed)
|
||
|
|
|
||
|
|
make maintainer-clean - removes files to return state back to same as
|
||
|
|
the CVS checkout (you will need to run ./autogen.sh again before running
|
||
|
|
make again)
|
||
|
|
|