WSO2 Identity Server

Branch	Build Status	Test Results
master

---

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

Looking for a Hosted Identity Solution?

Try 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.

Optimized developer experience

- 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. 

AI-assisted development

- Natural language for login flow requirements to automatically generate complex authentication flows. 
- Assisted brand matching to automatically generate all UX components

Industry-leading B2B CIAM capabilities, simplifying secure access for business customers and partners

- 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. 

Best API security available anywhere, using the powerful FAPI standard

- Additional security features built on top of the OAuth2 standard.
- Originating in financial services, but now desired by many industries. 

Unified user experience

- All-new administrative console.
- Shared with [Asgardeo](https://wso2.com/asgardeo/) and Private Identity Cloud. 

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 section in the documentation.
2. Make sure you have set the JAVA_HOME environment variable to point to your JDK. See this documentation 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 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/.
• Get help on Stack Overflow.
• Join the conversation on Discord.
• Learn more by reading articles from our 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 follow the details instructions available here: https://wso2.github.io

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.