Download the PHP package simplesamlphp/simplesamlphp-module-infocard without Composer
On this page you can find all versions of the php package simplesamlphp/simplesamlphp-module-infocard. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download simplesamlphp/simplesamlphp-module-infocard
More information about simplesamlphp/simplesamlphp-module-infocard
Files in simplesamlphp/simplesamlphp-module-infocard
Package simplesamlphp-module-infocard
Short Description A SimpleSAMLphp module that works with Information Cards techcnologies.
License
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package simplesamlphp-module-infocard
Information cards module for simpleSAMLphp
WARNING: THIS IS NOT mature software, it's released with testing, educational, developing purposes. It's on a very early version, so don't rely the life of anybody on it.
Introduction
This is a SimpleSAMLphp module that works with Information Cards technologies and provides two basic functionalities:
-
RP: acting as a Relying Party, you can accept user authentication through InfoCards consuming tokens sent by an STS.
-
STS: acting as a Secure Token Service you can provide information to a RP generating tokens. Currently, only user password and self issued credentials are supported.
- InfoCard Generator: your users could request their InfoCard filling a form with their username and password.
Very important
This document is not a strict guide, I mean it might have some errors or missed information. I've tried to comment almost every trick I've used to make the system work and make your life easier. So, if at any point of the installation you feel lost, breathe twice, think for ten minutes in what you are trying to do, read again the documentation and use your common sense. It'll be useful when you'll face again the configuration file.
Installation
Once you have installed SimpleSAMLphp, installing this module is very simple. Just execute the following command in the root of your SimpleSAMLphp installation:
where dev-master instructs Composer to install the master branch from the Git repository. See the
releases available if you
want to use a stable version of the module.
When you have successfully installed your module, you need to proceed with the following steps:
- Copy the InfoCard folder in your modules directory in your SimpleSAMLphp installation directory.
- Copy (or move) the file
modules/InfoCard/extra/config-login-infocard.phpto the config directory in your SimpleSAMLphp installation directory. - Edit the
config/config-login-infocard.phpfile, you should configure some values like:help_desk_email_URL,contact_info_URL,server_key,server_crt,sts_crt,requiredClaimsandoptionalClaimsto fit your needs. -
Edit the
config/authsources.phpfile, add the following text before the last);: - That's all.
Adding an Infocard Generator
- Go into the
modules/InfoCardfolder. - Copy
extra/getinfocard.phptowww/getinfocard.php -
Edit the
config/config-login-infocard.phpfile and uncomment this line: - Following the previous example, uncomment this
values:certificates,sts_key,tokenserviceurlandmexurl. - Check the previous values and modify them if you need.
- Read the User functions section.
Adding the STS functionality
- Go into the
modules/InfoCardfolder. - Copy
extra/mex.phpandextra/tokenservice.phpto thewwwfolder. - Edit the
config/config-login-infocard.phpfile and uncomment the values:certificatesandsts_key. - Read the User functions section.
User functions
Because there are many authentication issues I cannot guess for you, you'll have to code a little bit to fit this module to your authentication system.
We we'll work with the file UserFunctions.php located in modules/InfoCard/lib/.
-
validateUser: it receives two strings, username and password, you do the validation (against your database?) and return true if you want to validate the user or false instead. -
fillClaims: it's used by the tokenservice to give information about the user to the relying party. It receives the username, the configured required and optional claims and the claims requested by the RP. It works filling the claimValues array and your job is the ensure the value variable ($claimValues[$claim]['value']=) of the array gets the value you want. Understand that requested values and your configured ones could not match. fillICdata: it's used by the card generator to retrieve needed information. It receives an authenticated username and returns an array containing information such as the card name, the card image, the expiring time, etc.
Certificates and hosts
The architecture is composed by three independent elements:
- User: Identity Selector
- IDP: Relying Party
- STS: IC and token generation.
That's because you should configure two hosts (with two x509 certificates) if you want two have the IDP and STS functionalities in the same machine.
