This page shows how to configure MediaWiki to use eDirectory for user authentication, and how to configure authentication based on eDirectory group membership.

This page is part of the MediaWiki knowledge set.

Prerequisites

This document assumes that you have the following configured:

Sample Server Configuration

The authors used the following settings for this document. You may choose to use different names:

Installation

Download the latest version of LDAP Authentication for MediaWiki

Configuration

Overview

The LDAP Authentication module gets its settings from LocalSettings.php, which controls all configuration for MediaWiki.

To add the parameters needed for the LDAP Authentication to work you just need to append them to the end of your existing LocalSettings.php in your wiki directory.

Container-based User Access

The LDAP Authentication module allows MediaWiki to use containers as natural groups within eDirectory.

Changes to localSettings.PHP for Contextful Login

To enable simple user based authentication, append the following to your localSettings.PHP file:

require_once( 'extensions/LdapAuthentication.php' );
$wgAuth = new LdapAuthenticationPlugin();
$wgLDAPDomainNames = array( "{Wiki Identity variable}" );
$wgLDAPServerNames = array( "{Wiki Identity variable}"=>"{IP or DNS of wiki server}"  );
$wgLDAPSearchStrings = array( "{Wiki Identity variable}"=>"cn=USER-NAME,{LDAP name of eDirectory container}" );
#$wgLDAPSearchAttributes = array( "{Wiki Identity variable}"=>"uid" );
$wgLDAPUseSSL = array( "{Wiki Identity variable}"=>"ssl" );
$wgMinimalPasswordLength = 1;

Example for Contextlful Login

Here is how the authors' LocalSettings.php looks:

require_once( 'extensions/LdapAuthentication.php' );
$wgAuth = new LdapAuthenticationPlugin();
$wgLDAPDomainNames = array( "wikidemo" );
$wgLDAPServerNames = array( "wikidemo"=>"edir.wikidemo.org"  );
$wgLDAPSearchStrings = array( "wikidemo"=>"cn=USER-NAME,ou=users,o=novell" );
#$wgLDAPSearchAttributes = array( "wikidemo"=>"uid" );
$wgLDAPUseSSL = array( "{Wiki Identity variable}"=>"ssl" );
$wgMinimalPasswordLength = 1;

Changes to LocalSettings.php for Contextless Login

To enable simple user based authentication, append the following to your LocalSettings.php file:

require_once( 'extensions/LdapAuthentication.php' );
$wgAuth = new LdapAuthenticationPlugin();
$wgLDAPDomainNames = array( "{Wiki Identity variable}" );
$wgLDAPServerNames = array( "{Wiki Identity variable}"=>"{IP or DNS of wiki server}"  );
#$wgLDAPSearchStrings = array( "{Wiki Identity variable}"=>"cn=USER-NAME,{LDAP name of eDirectory container}" );
$wgLDAPSearchAttributes = array( "{Wiki Identity variable}"=>"uid" );
$wgLDAPUseSSL = array( "{Wiki Identity variable}"=>"ssl" );
$wgMinimalPasswordLength = 1;

Example for Contextless Login

Here is how the authors' LocalSettings.php looks:

require_once( 'LdapAuthentication.php' );
$wgAuth = new LdapAuthenticationPlugin();
$wgLDAPDomainNames = array( "wikidemo" );
$wgLDAPServerNames = array( "wikidemo"=>"edir.wikidemo.org"  );
$wgLDAPSearchStrings = array( "wikidemo"=>"cn=USER-NAME,ou=users,o=novell" );
$wgLDAPUseSSL = array( "{Wiki Identity variable}"=>"ssl" );
$wgMinimalPasswordLength = 1;

Details on Additions to LocalSettings.php

require_once( 'extensions/LdapAuthentication.php' );
$wgAuth = new LdapAuthenticationPlugin();

Tells MediaWiki to load the LdapAuthentication.php module

$wgLDAPDomainNames = array( "wikidemo" );

Sets the LDAPDomainName variable to "wikidemo." The name "wikidemo" will appear on the wiki's login page in the 'Your domain' field

$wgLDAPServerNames = array( "wikidemo"=>"edir.wikidemo.org"  );

Tells MediaWiki where to find the LDAP server. If you use a DNS name, make sure that the server can resolve the name to the right IP address for the eDirectory server.

$wgLDAPSearchStrings = array( "wikidemo"=>"cn=USER-NAME,ou=users,o=novell" );

This determines the context that to search for users. Additional contexts can be added by putting a single space between each context. Example:

There is no need to change cn=USER-NAME, if uid is used as your naming attribute, it can be specified using the next value: $wgLDAPSearchAttributes

$wgLDAPSearchAttributes = array( "wikidemo"=>"uid" );

This sets the wiki to use contextless login. If your accounts do not have the uid set and all accounts do have unique cn's; the $wgLDAPSearchAttributes can be changed to:

$wgLDAPSearchAttributes = array( "wikidemo"=>"cn" );

$wgLDAPUseSSL = array( "wikidemo"=>"ssl" );

Turns on SSL. SSL or TLS should only be turned off for for testing/troubleshooting. Available options are "ssl", "tls" and "clear"; the default is "tls".

$wgLDAPUseLocal = false;

This allows users to also login with a users name and password that is valid in MediaWiki's own identity store. *The admin user name and password created during the installation of MediaWiki are in this store, so changing this to true can provide a backdoor into the wiki in case of a directory outage. false is the default, so defining this isn't truly needed.

$wgLDAPAddLDAPUsers = array( "wikidemo"=>"false" );

Disables the ability for MediaWiki to create new users via LDAP; false is the default, so defining this isn't truly needed.

$wgLDAPUpdateLDAP = array( "wikidemo"=>"false" );

Disables the ability for MediaWiki to update existing users (passwords) via LDAP; false is the default, so defining this isn't truly needed. Since MediaWiki does not have policy enforcement for strong passwords, this option is important to eDirectory administrators

$wgLDAPMailPassword = array( "wikidemo"=>"false" );

Disables the ability for MediaWiki to email a temporary password to users; false is the default, so defining this isn't truly needed.

$wgLDAPRetrievePrefs = array( "wikidemo"=>"false" );

Disables the ability for MediaWiki retrieve LDAP preferences; false is the default, so defining this isn't truly needed.

$wgMinimalPasswordLength = 1;

Before MediaWiki will even try and authenticate to eDirectory it will make sure the user entered a password that is at least 'x' characters

Group-based Authentication

Group-based authentication restricts access to just the users who are members of a specific group.

Group-based authentication works for either contextful or contextless login.

To enable group-based authentication for an eDirectory group called "wikigroup" (DN=.wikigroup.users.novell), add the following line to localSettings.PHP:

$wgLDAPGroupDN = "cn=wikigroup,ou=users,o=novell";

The authors could not get more than one group to work. If you do, please update.

See: new-style group login restriction. The method shown above uses the deprecated style of group login restriction.

See Also

Após sofrer um pouco com a utilização do subversion, fiz este tutorial para facilitar minha vida e para ajudar também alguém que possa precisar.

Para este tutorial levamos em consideração que o subversion já está instalado e configurado no servidor. A partir daí seguem alguns comandos básicos (executados no terminal) para efetuar a criação e utilização de repositórios do subversion no linux.

No subversion, não existe a revisão de um determinado arquivo. Os arquivos não tem versões independentes. Todos os arquivos são parte de uma mesma revisão, e a modificação de um único arquivo altera a revisão de todos.

O subversion é um sistema de controle de versões que utiliza o conceito de branches, tags e trunk. Abaixo seguem alguns conceitos para melhor compreensão:

Trunk

A pasta trunk contém os projetos que estão em desenvolvimento. Todas as atualizações efetuadas dia-a-dia são armazenadas na pasta trunk.

Branches

A pasta branches é aquela que contém “linhas de desenvolvimento” de tal projeto, que entre elas podem haver poucas diferenças, porém uma independe da outra.

Quando a equipe decide que o projeto está pronto para ser liberado como uma versão, a pasta trunk é copiada para a pasta branch e dado um nome de versão. Este branch é congelado e não sofre mais alterações, apenas correções. Rigorosos testes são efetuados.

Tags

Quando os testes efetuados encima de um branch estão completos, a versão que se encontra no branch é copiada para a pasta tags, formando assim um “release” ou uma versão “liberada”. Esta pasta tag é empacotada e enviada para o cliente. Qualquer modificação em branch, deve ser copiada para a pasta de tags, após todos os testes.

Svn considera tag apenas uma variação de um branch, e na prática é exatamente como um branch, apenas uma cópia da ramificação atual da árvore.

svnadmin

Uma ferramenta para criar, ajustar ou reparar um repositório Subversion.

Criando um repositório

svnadmin create

ou

svnadmin create /

*Para alterar alguma coisa no repositório é necessário, após a criação, baixar uma cópia de trabalho, através do comando “checkout”, alterar e usar o comando “commit” para enviar alterações.

svnserve

Um programa servidor independente, que roda como um processo daemon ou pode ser invocado via SSH. É um modo de tornar o repositório disponível na rede.

Tornando o repositório disponível na rede através do protocolo svn

svnserve -d -r

Desta forma, pode-se acessar o repositório de outras máquinas, através do ip ou hostname.

svn ls svn://

svn

O programa cliente para linha de comando.

Comandos para as funcionalidades do controle de versão (checkout, commit, update, etc.)

*Cada comando possui subcomandos para ações específicas.

Importando arquivo ou conteúdo de diretório para o repositório

svn import svn:// -m

ou

svn import file:/// -m *É necessario o uso de um protocolo (svn, file, etc.), pois o svn só trabalha com url’s.

*Ao importar um diretório, para usar o conceito de branch, tag e trunk, é necessário que se importe uma pasta à qual contém o projeto a ser armazenado no repositório contendo as pastas branch e tag (ambas vazias) e trunk (com os arquivos do projeto).

Adicionando arquivos ou diretórios

svn add

*Os arquivos serão adicionados ao repositório no próximo commit.

Removendo arquivos do repositório

svn rm

svn commit *Exclui da cópia local e dá um commit para o repositório

ou

svn rm *Para excluir diretamente do repositório

Listar todos os repositórios disponíveis no servidor srvbuild.

svn ls

ou

svn list

Há também outra forma de listar o conteúdo do repositório, passando diretamente o caminho onde ele se encontra no disco.

svn ls file:///

Outros parâmetros podem ser passados, como formas diferentes de listar o conteúdo do repositório.

svn ls –recursive *Desce recursivamente aos conteúdos de cada diretório

svn ls –verbose *Lista informações adicionais

Baixar uma cópia dos arquivos disponíveis no repositório

svn co

ou

svn checkout

Adicionalmente podem ser passados alguns parâmetros para baixar revisões específicas.

svn co svn:/// -r

ou

svn co file:/// -r *Neste caso para acessar diretamente o local onde se encontra o repositório

Visualizar informações referentes à uma cópia de trabalho ou item remoto

svn info

ou

svn info

Atualizar uma cópia local com a disponível no repositório

svn update *Se estiver na pasta local de trabalho

ou

svn update

Listar modificações feitas na cópia de trabalho.

svn diff *Se estiver na pasta local de trabalho

ou

svn diff

svn diff lista as linhas dos arquivos que sofreram modificações daquelas que estão no repositório.

Listar os arquivos modificados na cópia de trabalho

svn status *Se estiver na pasta local de trabalho

ou

svn status

svn status lista os arquivos que sofreram modificações daqueles que estão no repositório.

Enviar as alterações efetuadas na cópia local para o repositório.

svn commit -m *Se estiver na pasta à qual possui os arquivos locais do repositório

ou

svn commit -m *A frase é o relato das alterações que estão sendo postadas

Liberar uma “release” para o repositório

Após efetuar todos os testes encima do projeto em desenvolvimento o mesmo deve ser disponibilizado como uma cópia estável para a pasta branches do projeto que está sendo desenvolvido. Para isso, é necessário fazer um checkout da ultima versão do projeto no repositório e simplesmente copiar a pasta trunk para dentro da pasta branches.

Trabalhando com a cópia local:

svn checkout /

cd

svn copy trunk branches/ *Copiando a pasta trunk para a pasta branches

svn status *Para listar os arquivos que sofreram modificações.

svn commit *Somente agora as alterações vão para o repositório

Trabalhando diretamente no repositório

O comando svn copy pode operar sobre diretórios ou diretamente sobre as URL’s do repositório.

svn copy //trunk //branches -m

Visualizar logs de alterações

svn log *Mostra as descrições das alterações feitas nos arquivos ou diretórios

ou

svn log –verbose *Mostra as descrições e os arquivos que sofreram alterações

Propriedades

É possível a atribuição de propriedades à arquivos ou diretórios contidos no repositório.

Listar propriedades de um projeto

svn propget

ou

svn status *Se estiver na pasta à qual possui os arquivos locais do repositório

ou

svn status

Setar propriedades em um projeto

svn propset copyright ‘’ svn://srvbuild/repos/sgiapi-testes

ou

svn propset -R

ou

svn propset -F

*As propriedades devem ser setadas em uma cópia local, e realizar commit para efetivação no repositório.

Existem vários tipos de propriedades definidas pelo subversion que podem ser atribuidas aos projetos.

Ligações Externas (svn:externals)

As definições externas são um tipo especial de propriedades, que criam um link à arquivos em outro local no repositório. São um mapeamento de um diretório local para a URL.

Alguns comandos para trabalhar com definições externas:

Setar a propriedade svn:externals para uma cópia local

svn propset svn:externals “ ”

svn commit *Para enviar as ligações externas ao repositório

Desta forma, é criado um link à pasta dentro do fazendo com que, após o commit, sem que se realize um checkout sobre o repositório, automaticamente se baixe os fontes referentes à definição externa. É bastante útil, caso possua uma API, ou libs que sejam necessários para vários projetos. Sendo que quando se realiza manutenção sobre a API ou sobre as libs, a mesma se aplica a todos os projetos que fazem dela uma definição externa.

Listar Ligações externas à um projeto

svn propget svn:externals

*Lembrando que os exemplos entre “” deverão ser substituídos pelo caminho do arquivo ou diretório ou url.

Fonte:  http://samuca.wordpress.com/2007/04/12/tutorial-subversion/