Asgardeo SAML SDK for Java

The Asgardeo SAML SDK for Java enables software developers to integrate SAML based SSO authentication with Java Web applications. The SDK is built on top of the OpenSAML library which allows Java developers to develop cross-domain single sign-on and federated access control solutions with minimum hassle.

Table of Contents

• Installing the SDK
  • Github
  • Building from the source
  • Maven
• Contributing
  • Reporting Issues
• Versioning
• License

Installing the SDK

Github

The SDK is hosted on github. You can download it from:

• Latest release: https://github.com/asgardeo/asgardeo-java-saml-sdk/releases/latest
• Master repo: https://github.com/asgardeo/asgardeo-java-saml-sdk/tree/master/

Building from the source

If you want to build identity-agent-sso from the source code:

1. Install Java 8
2. Install Apache Maven 3.x.x (https://maven.apache.org/download.cgi#)
3. Get a clone or download the source from this repository (https://github.com/asgardeo/asgardeo-java-saml-sdk.git)
4. Run the Maven command mvn clean install from the asgardeo-java-saml-sdk directory.

Maven

Install it as a maven dependency:

<dependency>
    <groupId>io.asgardeo.java.saml.sdk</groupId>
    <artifactId>io.asgardeo.java.saml.sdk</artifactId>
    <version>0.1.19</version>
</dependency>

The SDK is hosted at the WSO2 Internal Repository. Point to the repository as follows:

<repositories>
    <repository>
        <id>wso2.releases</id>
        <name>WSO2 internal Repository</name>
        <url>http://maven.wso2.org/nexus/content/repositories/releases/</url>
        <releases>
            <enabled>true</enabled>
            <updatePolicy>daily</updatePolicy>
            <checksumPolicy>ignore</checksumPolicy>
        </releases>
    </repository>
</repositories>

Contributing

Please read Contributing to the Code Base for details on our code of conduct, and the process for submitting pull requests to us.

Reporting Issues

We encourage you to report issues, improvements, and feature requests creating git Issues.

Important: And please be advised that security issues must be reported to [email protected], not as GitHub issues, in order to reach the proper audience. We strongly advise following the WSO2 Security Vulnerability Reporting Guidelines when reporting the security issues.

Versioning

For the versions available, see the tags on this repository.

License

This project is licensed under the Apache License 2.0 under which WSO2 Carbon is distributed. See the LICENSE file for details.