{"id":20215578,"url":"https://github.com/casdoor/casdoor-java-sdk","last_synced_at":"2026-01-28T13:04:18.343Z","repository":{"id":38838376,"uuid":"367000464","full_name":"casdoor/casdoor-java-sdk","owner":"casdoor","description":"Java client SDK for Casdoor","archived":false,"fork":false,"pushed_at":"2024-12-16T14:21:51.000Z","size":245,"stargazers_count":27,"open_issues_count":0,"forks_count":43,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-12T14:56:18.429Z","etag":null,"topics":["auth","authentication","authn","casdoor","java","jwt","keycloak","oauth","oidc","sdk","sso"],"latest_commit_sha":null,"homepage":"https://github.com/casdoor/casdoor","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/casdoor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-13T09:34:21.000Z","updated_at":"2024-12-16T14:20:43.000Z","dependencies_parsed_at":"2023-10-17T00:03:12.119Z","dependency_job_id":"89a01706-5e5d-4606-9c04-680a14608570","html_url":"https://github.com/casdoor/casdoor-java-sdk","commit_stats":null,"previous_names":[],"tags_count":50,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casdoor%2Fcasdoor-java-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casdoor%2Fcasdoor-java-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casdoor%2Fcasdoor-java-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casdoor%2Fcasdoor-java-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/casdoor","download_url":"https://codeload.github.com/casdoor/casdoor-java-sdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254564121,"owners_count":22092121,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auth","authentication","authn","casdoor","java","jwt","keycloak","oauth","oidc","sdk","sso"],"created_at":"2024-11-14T06:23:22.458Z","updated_at":"2026-01-28T13:04:18.336Z","avatar_url":"https://github.com/casdoor.png","language":"Java","readme":"# casdoor-java-sdk\n\n[![GitHub Actions](https://github.com/casdoor/casdoor-java-sdk/actions/workflows/maven-ci.yml/badge.svg)](https://github.com/casdoor/casdoor-java-sdk/actions/workflows/maven-ci.yml)\n[![codebeat badge](https://codebeat.co/badges/e3e92eff-8b71-4903-9764-5126e855b3b6)](https://codebeat.co/projects/github-com-casdoor-casdoor-java-sdk-master)\n[![codecov](https://codecov.io/gh/casdoor/casdoor-java-sdk/branch/master/graph/badge.svg?token=1C2FSTN4J8)](https://codecov.io/gh/casdoor/casdoor-java-sdk)\n[![Javadocs](https://www.javadoc.io/badge/org.casbin/casdoor-java-sdk.svg)](https://www.javadoc.io/doc/org.casbin/casdoor-java-sdk)\n[![Maven Central](https://img.shields.io/maven-central/v/org.casbin/casdoor-java-sdk.svg)](https://mvnrepository.com/artifact/org.casbin/casdoor-java-sdk/latest)\n[![Release](https://img.shields.io/github/release/casdoor/casdoor-java-sdk.svg)](https://github.com/casdoor/casdoor-java-sdk/releases/latest)\n[![Discord](https://img.shields.io/discord/1022748306096537660?logo=discord\u0026label=discord\u0026color=5865F2)](https://discord.gg/5rPsrAzK7S)\n\nThis is Casdoor's SDK for java, which will allow you to easily connect your application to the Casdoor authentication system without having to implement it from scratch.\n\nCasdoor SDK is very simple to use. We will show you the steps below.\n\n## Step1. Init Config\n\nInitialization requires 5 parameters, which are all string type:\n\n| Name (in order)  | Must | Description                                         |\n|------------------|------|-----------------------------------------------------|\n| endpoint         | Yes  | Casdoor Server Url, such as `http://localhost:8000` |\n| clientId         | Yes  | Client ID for the Casdoor application               |\n| clientSecret     | Yes  | Client secret for the Casdoor application           |\n| certificate      | Yes  | The public key for the Casdoor application's cert   |\n| organizationName | Yes  | The name for the Casdoor organization               |\n| applicationName  | No   | The name for the Casdoor application                |\n\n```java\nCasdoorConfig config = new CasdoorConfig(endpoint, clientId, clientSecret, certificate, organizationName, applicationName);\n```\n\n## Step2. Get Service and use\n\nNow provide two services: ``CasdoorUserService``, ``CasdoorAuthService``\n\nYou can create them like\n\n```Java\nCasdoorUserService casdoorUserService = new CasdoorUserService(config);\n```\n\n## UserService\n\n``CasdoorUserService`` support basic user operations, like:\n\n- `GetUser(name string)`, get one user by user name.\n- `GetUsers()`, get all users.\n- `UpdateUser(auth.User)/AddUser(auth.User)/DeleteUser(auth.User)`, write user to database.\n\n## AuthService\n\n1. **Get token and parse**\n\nAfter casdoor verification passed, it will be redirected to your application with code and state, like `http://forum.casbin.org?code=xxx\u0026state=yyyy`.\n\nYour web application can get the `code`,`state` and call `GetOAuthToken(code, state)`, then parse out jwt token.\n\nThe general process is as follows:\n\n```java\nString token = authService.getOAuthToken(code, state);\n\nCasdoorUser user = authService.parseJwtToken(token);\n```\n\n2. **Set Session in your app**\n\n`user` contains the basic information about the user provided by casdoor, you can use it as a keyword to set the session in your application, like this:\n\n```java\nHttpSession session = request.getSession();\nsession.setAttribute(\"user\", user);\n```\n\n## SpringBoot Support\n\nIf you use SpingBoot for your application, you can use [casdoor-spring-boot-starter](https://github.com/casdoor/casdoor-spring-boot-starter)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasdoor%2Fcasdoor-java-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcasdoor%2Fcasdoor-java-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasdoor%2Fcasdoor-java-sdk/lists"}