asgardeo / asgardeo-java-saml-sdk Goto Github PK

SAML Java SDK for Asgardio

License: Apache License 2.0

Java 100.00%

asgardeo-java-saml-sdk's Introduction

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.

Installing the SDK
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:

Install Java 8
Install Apache Maven 3.x.x (https://maven.apache.org/download.cgi#)
Get a clone or download the source from this repository (https://github.com/asgardeo/asgardeo-java-saml-sdk.git)
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.

asgardeo-java-saml-sdk's People

Contributors

Stargazers

Watchers

Forkers

gayashanbc brionmario chamathns hoabuiyt boulik dinikasen ayshsandu senthalan sanojpunchihewa isankasr thanujalk donomalvindula afrahussaindeen anuradhask

asgardeo-java-saml-sdk's Issues

Exception throws when ErrorPage or IndexPage properties are not configured in the configuration file

Description:
Below exception throws when ErrorPage property is not configured in the configuration file at the logout
java.lang.IllegalArgumentException: Path [samlsso?SAML2.HTTPBinding=HTTP-POST] does not start with a "/" character

Suggested Labels:

SAML,SLO,Tomcat
Suggested Assignees:

Affected Product Version:
sgardio-java-oidc-sdk release version 0.1.16
OS, DB, other environment details and versions:
WSO2 IAM 5.10.0, Tomcat 9.0

Steps to reproduce:

Setup asgardio tomcat sample app : https://github.com/asgardio/asgardio-tomcat-saml-agent/tree/master/io.asgardio.tomcat.saml.agent.sample by using asgardio-java-oidc-sdk release version 0.1.16
Remove below properties from the sample-app.properties
IndexPage=/sample-app/index.html
ErrorPage=/error.jsp
Check the logout flow

Allow to configure the IDP Public Certificate as an encoded string

Description

Implement functionality allowing to configure the IDP Public Certificate as an encoded string.
A new property name IDP_PUBLIC_CERT needs to be introduced to handle this configuration.

Optimize the dependencies

Describe the issue:
With the current dependencies, the web apps being built using the java-saml-sdk tends to grow >50MB in size.
To avert this, we need to optimize the dependencies added in the https://github.com/asgardeo/asgardeo-java-saml-sdk/blob/master/pom.xml

Allow configuration via SAML IDP Metadata file

Description

It would be nice to have an option to configure the SDK via a SAML IDP Metadata file.

Functionality Improvements for the SAML SDK

Description:

A few improvements have been identified for the SAML SDK which would add to the scope of the functionality that could be utilized by the developer.

Tasks:

The following are the main tasks that has been identified for the first phase of the improvements.

Add support for an error page via the properties file.
A page to customize the redirect page upon error response.
Add support for a target page.
A page to customize the redirect page upon successful authentication.
Refactor the SSOAgentConfigs and SSOAgentConfig classes.

Revamp the POST-binding redirect page.

Describe the issue:
The current post-binding redirect page uses a HTML payload with minimal styling.
This needs to be updated in a user-configurable manner. Meaning the user should be able to configure this redirect page via the asgardeo-tomcat-saml-agent.

asgardeo / asgardeo-java-saml-sdk Goto Github PK

asgardeo-java-saml-sdk's Introduction

Asgardeo SAML SDK for Java

Table of Contents

Installing the SDK

Github

Building from the source

Maven

Contributing

Reporting Issues

Versioning

License

asgardeo-java-saml-sdk's People

Contributors

Stargazers

Watchers

Forkers

asgardeo-java-saml-sdk's Issues

Description

Description

Recommend Projects

Recommend Topics

Recommend Org