<a href="http://wso2.com/products/identity-server/">
<img src="https://wso2.cachefly.net/wso2/sites/all/image_resources/wso2-branding-logos/wso2-logo-orange.png" alt="WSO2 logo" width=30% height=30% />

</a>

# WSO2 Identity Server

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/wso2/product-is/blob/master/LICENSE)
[![Get Support on Stack Overflow](https://img.shields.io/badge/stackoverflow-wso2is-orange)](https://stackoverflow.com/questions/tagged/wso2is)
[![Join the community on Discord](https://img.shields.io/badge/Join%20us%20on-Discord-%23e01563.svg)](https://discord.com/invite/wso2)
[![X](https://img.shields.io/twitter/follow/wso2.svg?style=social&label=Follow)](https://twitter.com/intent/follow?screen_name=wso2)


|  Branch | Build Status | Test Results |
| :------------ |:------------- |:-------------
| master      | [![Build Status](https://wso2.org/jenkins/job/products/job/product-is/badge/icon)](https://wso2.org/jenkins/job/products/job/product-is/) | [![Test Results](https://wso2.org/jenkins/job/products/job/product-is/badge/icon)](https://wso2.org/jenkins/job/products/job/product-is/lastBuild/testReport/) |

---

WSO2 Identity Server is a powerful, modern identity and access management solution for your on-premises or cloud environment. It enables organizations to deliver exceptional, trusted digital experiences to all types of users.

To learn more about WSO2 Identity Server please visit [WSO2 Identity Server website](https://wso2.com/identity-server/)


> ##### Looking for a Hosted Identity Solution?
> Try **[Asgardeo](https://wso2.com/asgardeo/)** free of charge – a public identity cloud solution (iDaaS) offering, built on the same technology core as **WSO2 Identity Server**.


Why WSO2 Identity Server?
=========================
Whether you’re securing apps for external consumers, internal workforce, business customers, or even API access, WSO2 Identity Server provides the modern, full-featured identity and access foundation you need. 

Customers prefer Identity Server for its developer-centric design, extensive standards support, freedom to deploy however needed, and massive scalability.

<details>
  <summary>Optimized developer experience</summary>
          
    - New visual designer that simplifies development of authentication flows. 
    - New templates to easily configure apps and authentication methods. 
    - Simplified use of RBAC to define fine-grained API access policies. 
    - New authentication API for in-app authentication, further streamlining user access. 
</details>

<details>
  <summary>AI-assisted development</summary>
            
    - Natural language for login flow requirements to automatically generate complex authentication flows. 
    - Assisted brand matching to automatically generate all UX components
</details>

<details>
  <summary>Industry-leading B2B CIAM capabilities, simplifying secure access for business customers and partners</summary>
              
    - Advanced RBAC to define delegated administration rights.
    - Choice of login options per customer, including enterprise IDP. 
    - Subscription model to ensure the right apps are available to customers.
    - Customizable branding per customer to ensure the highest user engagement.
    - Rich support for various organization hierarchies, such as B2B2C. 
</details>

<details>
  <summary>Best API security available anywhere, using the powerful FAPI standard</summary>
              
    - Additional security features built on top of the OAuth2 standard.
    - Originating in financial services, but now desired by many industries. 
</details>

<details>
  <summary>Unified user experience</summary>
              
    - All-new administrative console.
    - Shared with [Asgardeo](https://wso2.com/asgardeo/) and Private Identity Cloud. 
</details>


Getting Started
===================
## System prerequisites

Refer to this page to consult pre-requisites based on your target architecture and operating system: https://is.docs.wso2.com/en/latest/deploy/get-started/install

Installation
----------------------------------

1. WSO2 Identity Server requires a JDK to run and supports versions from JDK 11 through JDK 21. For the full list of supported versions, please refer to the [environment compatibility](https://is.docs.wso2.com/en/latest/deploy/get-started/install/#environment-compatibility) section in the documentation.
2. Make sure you have set the `JAVA_HOME` environment variable to point to your JDK. See [this documentation](https://is.docs.wso2.com/en/latest/deploy/get-started/install/#install-on-different-platforms) if you need help doing so. 
3. Extract the downloaded distribution zip file and go to the 'bin' directory
4. Run the wso2server.sh or wso2server.bat script based on your operating system.
5. Access the respective WSO2 Identity Server interfaces
    * **Developer and Administrator Console** web application is running at: https://localhost:9443/console \
      You may sign in to the Developer and Administrator Console using the default administrator credentials (username: admin, password: admin).
    * **End User Portal** web application is running at: - https://localhost:9443/myaccount \
      You may sign in to the End User Portal using the default administrator credentials (username: admin, password: admin).

## Try out a sample app or build your own sample app

Follow our [Quick Start guide ](https://is.docs.wso2.com/en/latest/get-started/start-integrating-apps/) to try out a sample app or build your own sample app.

Reporting Product Issues
========================
All known issues of WSO2 IS are filed at: https://github.com/wso2/product-is/issues. Please check this list before opening a new issue.

#### Opening an issue
Help us make our software better! Submit any bug reports or feature requests through GitHub: https://github.com/wso2/product-is/issues.

#### Reporting Security Issues
Please do not report security issues via GitHub issues. Instead, follow the WSO2 Security Vulnerability Reporting Guidelines.


Join our community!
========================
- Read our documentation at [https://is.docs.wso2.com/en/latest/](https://is.docs.wso2.com/en/latest/).
- Get help on [Stack Overflow](https://stackoverflow.com/questions/tagged/wso2-is).
- Join the conversation on [Discord](https://discord.gg/wso2).
- Learn more by reading articles from our [library](https://wso2.com/library/).





Commercial Support
==================
You can take advantage of a WSO2 on-prem product subscription for the full range of software product benefits like expert support, continuous product updates, vulnerability monitoring, and access to the licensed distribution for commercial use.

To learn more, check WSO2 Subscription.



Contributing
===============
If you are planning on contributing to the development efforts of WSO2 Identity Server, you can do that by checking out the latest development version. The master branch holds the latest unreleased source code.

Please read our [Contribution Guide](./docs/CONTRIBUTING.md) for detailed instructions on how to contribute.

Can you fill this survey ?
WSO2 wants to learn more about our open source software (OSS) community and your communication preferences to serve you better.

In addition, we may reach out to a small number of respondents to ask additional questions and offer a small gift.

Survey is available at: https://forms.gle/h5q4M3K7vyXba3bK6

---------------------------------------------------------------------------
(c) Copyright 2019 - 2025 WSO2 LLC. All Rights Reserved.
