Create user using user_name or email in WSO2 Idenity Server

Prerequisites:-
WSO2 Identity Server 5.0.0 or above

WSO2 Identity Server you can authenticate using user_name or email. By default authenticate using user_name.

For that , you need to uncomment the EnableEmailUserName in carbon.xml file  [IS_HOME]/repository/conf/ directory as below.

    <!-- Enable following config to allow Emails as usernames. -->
    <EnableEmailUserName>true</EnableEmailUserName>

After you need to do the below changes as well,

1. Add new property in to the [IS_HOME]/repository/conf/user-mgt.xml file as below,

   <Property name="UsernameWithEmailJavaScriptRegEx">[a-zA-Z0-9@._-|//]{3,30}$</Property>

2. Do the below changes in user-mgt.xml file as well,<Property name="UsernameJavaRegEx">[a-zA-Z0-9@._-|//]{3,30}$</Property>
<Property name="UsernameJavaScriptRegEx">[a-zA-Z0-9._-|//]{3,30}$</Property>

After that you can create user using UserName or Email and login as well.
In additionally tenant creation use case, you need to create tenant admin with only email user_name. After that you can create users as your desire.

configure travelocity.com web app for SAML 2.0 authentication in WSO2 Identity Server

Prerequisites:-
WSO2 Identity Server 5.0.0 or above
travelocity.com web app

First of all we need to know what is travelocity.com web app. travelocity.com web application(.war file) we used to SAML 2.0 authentication and it's related scenario testing purpose with WSO2 IS.

For that we need to download the travelocity.com web app source code and build it using maven. SVN location below,

svn co http://svn.wso2.org/repos/wso2/carbon/platform/branches/turing/products/is/5.0.0/modules/samples/sso/

Replace the whole content with following in pom.xml file,

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

    <groupId>org.wso2.identity</groupId>

    <version>5.0.0</version>   

    <modelVersion>4.0.0</modelVersion>

    <artifactId>wso2is-identity-samples-sso</artifactId>

    <packaging>pom</packaging>

    <name>Identity Server : SSO Samples</name>

    <modules>

        <module>SSOAgentSample</module>

    </modules>

</project>

Build using below maven command, for that you need to go download sample /sso directory and run below command,

mvn clean install

Go to the /targat directory and copied the travelocity.war file into your [tomcat_home]/webapp directory and restart the tomcat. If your using latest tomcat version no need to restart.

Now travelocity.com sample ready for work. Go to browser and type below URL and you can see the travelocity sample app,

http://localhost:8080/travelocity.com/index.jsp

After that you need to start the WSO2 IS 5.0.0 and login as admin with credentials.
Navigate the main menu and click add under Service Provider. You can see below page.

Click register and then navigate the Inbound Authentication Configuration> SAML web SSO configuration> configure. After you need to configure the below details,

SP inbound configuration in SAML

Below pointed some important value you need to configure,
issuer:- 
This is the entity id for SAML2 service provider. For this  travelocity.com sample issuere is travelocity.com. 

Assertion Consumer [ACS] URL:-
Assertion Consumer Service (ACS) URL of the service provider. The identity provider redirects the SAML2 response to this ACS URL.

Use fully qualified username in the NameID:-
checked this as true. A fully qualified username is basically user name with user store domain.
username must be in the following format: {user store domain}{user name}

Enable Response Signing:-
checked this as true. This is used to sign the SAML2 Responses returned after the authentication process is complete.

Enable Attribute Profile:-
The Identity Server supports a basic attribute profile and it mean basic user information such as username,email,sex,telephone number. The identity provider can include the user’s attributes in the SAML Assertions as an attribute statement.
After completed this details click update. Then you can used above travelocity.com URL for test this.You can see the travelocity.com home page below,

travelocity home page

Before that you need to install browser addon(here I used firefox addon) for trace the SAML flow. This will help you to debug the SAML 2.0 issues. You can install the addon using below URL,

https://addons.mozilla.org/en-US/firefox/addon/saml-tracer/

After installation complete you can run the saml-tracer by navigating the tool>SAML Tracer.

Just click the below link in travelocity.com homepage,

Meanwhile redirect to the WSO2 IS login page. Login with admin credentials. By default both user name & password is "admin".
After login it redirect to the travelocity.com page as below,

If you start saml-tracer before login to the IS you can trace SAML as below, Here last POST response create the SAML2 assertion for travelocity.com issuer.

saml-tracer

Now you can see the SAML2 trace.