From 625ae5ece0700adcee594f507f983e1c45970d0e Mon Sep 17 00:00:00 2001 From: Xavier Guimard Date: Tue, 22 Oct 2013 12:14:44 +0000 Subject: [PATCH] Update documentation --- doc/index/alphabetical.html | 2 +- .../documentation/1.3/applications/sympa.html | 33 +++++++--- doc/pages/documentation/1.3/authwebid.html | 12 ++-- doc/pages/documentation/1.3/fastcgi.html | 62 +++++++++++++++++++ doc/pages/documentation/1.3/performances.html | 22 +++++-- doc/pages/documentation/1.3/start.html | 10 +-- doc/pages/start.html | 2 +- 7 files changed, 120 insertions(+), 23 deletions(-) create mode 100644 doc/pages/documentation/1.3/fastcgi.html diff --git a/doc/index/alphabetical.html b/doc/index/alphabetical.html index 5e4ea4d95..2507ca447 100644 --- a/doc/index/alphabetical.html +++ b/doc/index/alphabetical.html @@ -16,4 +16,4 @@ -

Alphabetical Index

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 

Back to main index

A

activedirectoryminihowto
applications
authad
authapache
authbasic
authbrowserid
authcas
authchoice
authdbi
authdemo
authfacebook
authgoogle
authldap
authmulti
authnull
authopenid
authproxy
authradius
authremote
authsaml
authslave
authssl
authtwitter
authwebid
authyubikey

B

browseablesessionbackend
bugzilla

C

cda
changeconfbackend
conferences
configlocation
configvhost
contact
customfunctions

D

default_sidebar
django
documentation
dokuwiki
download
drupal

E

error
exportedvars
extendedfunctions

F

features
federationproxy
fileconfbackend
filesessionbackend
formreplay

G

googleapps

H

handlerauthbasic
header_remote_user_conversion
highavailability

I

idpcas
idpopenid
idpsaml
installdeb
installrpm
installtarball
internalproxy

L

ldapconfbackend
ldapminihowto
ldapsessionbackend
liferay
limesurvey
loginhistory
logoutforward
logs

M

managerprotection
mediawiki
memcachedsessionbackend
menu1
mrtg
mysqlminihowto

N

nosqlsessionbackend
notifications

O

obm

P

parameterlist
passwordstore
performances
phpldapadmin
playground
portal
portalcustom
portalmenu
prereq
presentation
press

Q

quickstart

R

rbac
redirections
references
resetpassword

S

safejail
samlservice
screenshots
securetoken
security
selfmadeapplication
sessions
soapconfbackend
soapminihowto
soapservices
soapsessionbackend
spring
sqlconfbackend
sqlsessionbackend
ssocookie
start
status
sympa
syntax

T

tomcat
translations

U

upgrade

V

variables

W

writingrulesand_headers

Z

zimbra


Back to main index

\ No newline at end of file +

Alphabetical Index

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 

Back to main index

A

activedirectoryminihowto
applications
authad
authapache
authbasic
authbrowserid
authcas
authchoice
authdbi
authdemo
authfacebook
authgoogle
authldap
authmulti
authnull
authopenid
authproxy
authradius
authremote
authsaml
authslave
authssl
authtwitter
authwebid
authyubikey

B

browseablesessionbackend
bugzilla

C

cda
changeconfbackend
conferences
configlocation
configvhost
contact
customfunctions

D

default_sidebar
django
documentation
dokuwiki
download
drupal

E

error
exportedvars
extendedfunctions

F

fastcgi
features
federationproxy
fileconfbackend
filesessionbackend
formreplay

G

googleapps

H

handlerauthbasic
header_remote_user_conversion
highavailability

I

idpcas
idpopenid
idpsaml
installdeb
installrpm
installtarball
internalproxy

L

ldapconfbackend
ldapminihowto
ldapsessionbackend
liferay
limesurvey
loginhistory
logoutforward
logs

M

managerprotection
mediawiki
memcachedsessionbackend
menu1
mrtg
mysqlminihowto

N

nosqlsessionbackend
notifications

O

obm

P

parameterlist
passwordstore
performances
phpldapadmin
playground
portal
portalcustom
portalmenu
prereq
presentation
press

Q

quickstart

R

rbac
redirections
references
resetpassword

S

safejail
samlservice
screenshots
securetoken
security
selfmadeapplication
sessions
soapconfbackend
soapminihowto
soapservices
soapsessionbackend
spring
sqlconfbackend
sqlsessionbackend
ssocookie
start
status
sympa
syntax

T

tomcat
translations

U

upgrade

V

variables

W

writingrulesand_headers

Z

zimbra


Back to main index

\ No newline at end of file diff --git a/doc/pages/documentation/1.3/applications/sympa.html b/doc/pages/documentation/1.3/applications/sympa.html index d99d7c22a..effba19c7 100644 --- a/doc/pages/documentation/1.3/applications/sympa.html +++ b/doc/pages/documentation/1.3/applications/sympa.html @@ -44,7 +44,7 @@ There are two ways to configure SSO with Sympa:

    -
  • Auto login: a special LL::NG Handler will generate Sympa cookie
    +
  • Auto login: a special LL::NG Handler will generate Sympa cookie (for Sympa 5 only !)
  • Magic authentication: a special SSO URL is protected by LL::NG, Sympa will display a button for users who wants to use this feature.
    • @@ -56,9 +56,9 @@ There are two ways to configure SSO wi How to choose? Here are some advices:

      -
    • Auto login is very secure, as Sympa cookie is only exchanged between LL::NG Handler and Sympa (user cannot see it)
      +
    • Auto login is very secure for Sympa 5, as Sympa cookie is only exchanged between LL::NG Handler and Sympa (user cannot see it)
      • -
    • Magic authentication allows to mix standard Sympa authentication and SSO
      +
    • Magic authentication allows to mix standard Sympa authentication and SSO
    @@ -68,7 +68,7 @@ How to choose? Here are some advices:

- +

Configuration

@@ -78,7 +78,7 @@ Choose one of the following method:

- +

Auto login

@@ -133,7 +133,7 @@ Go in Manager, Default parameters » Advanced parameters
- +

Magic authentication

@@ -157,7 +157,7 @@ And fill it: 

 generic_sso
-        service_name                   LemonLDAP::NG
+        service_name                   Centralized auth service
         service_id                          lemonldapng
         email_http_header            HTTP_MAIL
         netid_http_header             HTTP_AUTH_USER
@@ -165,6 +165,21 @@ generic_sso
         logout_url                          http://sympa.example.com/wws/logout
+

+

+You can also disable internal Sympa authentication to keep only LemonLDAP::NG by removing user_table paragraph +

+ +

+Note that if you use FastCGI, you must restart Apache to enable changes. + +

+

+ +

+You can also use <portal>?logout=1 as logout_url to remove LemonLDAP::NG session when “disconnect” is chosen. +

+

Sympa virtual host in Apache

@@ -186,7 +201,7 @@ Configure Sympa virtual host like other VirtualHost>

-

The location URL is based on the service_id defined in Sympa apache configuration. +

The location URL end is based on the service_id defined in Sympa apache configuration.

@@ -211,4 +226,4 @@ Configure the
\ No newline at end of file +
\ No newline at end of file diff --git a/doc/pages/documentation/1.3/authwebid.html b/doc/pages/documentation/1.3/authwebid.html index 52971e8d3..8e592ae8c 100644 --- a/doc/pages/documentation/1.3/authwebid.html +++ b/doc/pages/documentation/1.3/authwebid.html @@ -109,11 +109,15 @@ SSLVerifyClient optional_no_ca

To test this, you can build your own WebID certificate using one of : - * Web::ID::Certificate::Generator - * my-profile.eu - * gen-webid-cert.sh -

+ \ No newline at end of file diff --git a/doc/pages/documentation/1.3/fastcgi.html b/doc/pages/documentation/1.3/fastcgi.html new file mode 100644 index 000000000..40dad37d9 --- /dev/null +++ b/doc/pages/documentation/1.3/fastcgi.html @@ -0,0 +1,62 @@ + + + + + + + + + + + + + + + + + +
+ + + + +

Fast CGI support

+
+ +

+ +LL::NG CGIs (Portal, Manager,…) can be used under a Fast CGI system very easily. You just have to load LL::NG fast CGI support and write a loop in the CGI. Example with the portal: + +

#!/usr/bin/perl
+use Lemonldap::NG::Common::CGI qw(fastcgi);
+use Lemonldap::NG::Portal::SharedConf;
+# ...
+
+LMAUTH: while ( my $portal = Lemonldap::NG::Portal::SharedConf->new({}) ) {
+    # ...
+}
+
+ +

+ +

+Key steps : +

+
    +
  • Load “Lemonldap::NG::Common::CGI qw(fastcgi)“ before any other LL::NG library
    +
    • +
  • insert a loop around the HTML printing, starting with the object creation (→new)
    +
    • +
  • insert a label “LMAUTH” ahead of the loop
    +
    • +
+ +

+ +An example is given under the source tree : lemonldap-ng-portal/example/index.fcgi +

+ +
+
\ No newline at end of file diff --git a/doc/pages/documentation/1.3/performances.html b/doc/pages/documentation/1.3/performances.html index c1f17e653..70d034296 100644 --- a/doc/pages/documentation/1.3/performances.html +++ b/doc/pages/documentation/1.3/performances.html @@ -129,8 +129,22 @@ The portal is the biggest component of Lemonldap::NG. It is recommended to use M PerlResponseHandler ModPerl::Registry </Files> +

+You can also use a Fast CGI server using index.fcgi given in portal examples. +

+ - + +

Configuration access

+
+ +

+ +If you set useLocalConf to 1 in lemonldap-ng.ini (section [Portal]), the portal will use only a cached configuration. To refresh it, you have to set an handler on the same server to use the refresh mechanism or to restart the server after each configuration change. +

+ +
+

Starting performances

@@ -150,7 +164,7 @@ To make the portal start faster when the server is relaunched, add those lines i </Perl>
- +

Apache::Session performances

@@ -222,7 +236,7 @@ Note that Apache::Session::Browseable::MySQL doesn't use MySQL locks.

- +

LDAP performances

@@ -272,4 +286,4 @@ ldapgroups -> memberOf

- \ No newline at end of file + \ No newline at end of file diff --git a/doc/pages/documentation/1.3/start.html b/doc/pages/documentation/1.3/start.html index 8351bf9a5..4c48ce23a 100644 --- a/doc/pages/documentation/1.3/start.html +++ b/doc/pages/documentation/1.3/start.html @@ -339,7 +339,7 @@ Sessions are stored using +
@@ -371,12 +371,14 @@ Sessions are stored using
AuthBasic Handler
+
  • Fast CGI support
    +
  • See full parameters list
    • - +

    Mini howtos

    @@ -405,7 +407,7 @@ Sessions are stored using +

    Exploitation

    @@ -434,4 +436,4 @@ Sessions are stored using
    \ No newline at end of file +
    \ No newline at end of file diff --git a/doc/pages/start.html b/doc/pages/start.html index ca4fec5f6..7587b60a7 100644 --- a/doc/pages/start.html +++ b/doc/pages/start.html @@ -285,6 +285,6 @@ LemonLDAP::NG is the first SSO softwar

    - + \ No newline at end of file