{"id":16376250,"url":"https://github.com/decebals/licensius","last_synced_at":"2025-03-21T01:32:16.652Z","repository":{"id":27278595,"uuid":"30751876","full_name":"decebals/licensius","owner":"decebals","description":"Tiny License Framework for Java","archived":false,"fork":false,"pushed_at":"2018-10-11T11:48:09.000Z","size":29,"stargazers_count":68,"open_issues_count":2,"forks_count":22,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-10-12T03:24:09.252Z","etag":null,"topics":["java","license"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/decebals.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-13T10:33:19.000Z","updated_at":"2024-08-23T13:54:38.000Z","dependencies_parsed_at":"2022-07-25T17:22:10.916Z","dependency_job_id":null,"html_url":"https://github.com/decebals/licensius","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decebals%2Flicensius","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decebals%2Flicensius/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decebals%2Flicensius/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decebals%2Flicensius/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/decebals","download_url":"https://codeload.github.com/decebals/licensius/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244721368,"owners_count":20498936,"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":["java","license"],"created_at":"2024-10-11T03:24:05.999Z","updated_at":"2025-03-21T01:32:16.397Z","avatar_url":"https://github.com/decebals.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"Tiny License Framework for Java\n=====================\n[![Travis CI Build Status](https://travis-ci.org/decebals/licensius.png)](https://travis-ci.org/decebals/licensius)\n[![Maven Central](http://img.shields.io/maven-central/v/ro.fortsoft.licensius/licensius.svg)](http://search.maven.org/#search|ga|1|ro.fortsoft.licensius)\n\nIt's an open source (Apache license) tiny (only 14KB) license framework in Java, with zero dependencies and a quick learning curve.\n\nHow to use\n-------------------\n```java\nLicenseManager licenseManager = LicenseManager.getInstance();\nLicense license = licenseManager.getLicense();\nlicenseManager.isValidLicense(license);\n```\n\nIn `private.key` file exists the private key used to create the license.  \nIn `public.key` file exists the public key used to validate the license.  \nThe public key (`public.key`) is delivered with your application jar.  \n\nTo create a new license, you must create a template file (`template.dat`) that contains all license's components\nand to run `LicenseTool`.  \nIf the private key or the public key doesn't exists then Licensius will create these files for you. \nThe license will be a `license.dat` file.  \n\nBy default Licensius using DSA algorithm (the key length in bits is 1024) for generating keys (private and public).\n\nLicensius uses `X509EncodedKeySpec` to encode the public key and `PKCS8EncodedKeySpec` to encode the private key. Both `public.key` file and `private.key` file are binaries.\n\nIn `example` folder you have an example for license template (input) and and its associated license (output).  \n\nThe content for `template.dat` can be (see example folder):\n```properties\nexpirationDate=9/12/2020\ncompanyName=HomeOffice\nemailAddress=office@home.ro\n```\n\nIn this case the content for `license.dat` (the license) is:\n```properties\n#License file\n#Fri Feb 13 14:57:14 EET 2015\nexpirationDate=9/12/2020\ncompanyName=HomeOffice\nemailAddress=office@home.ro\nsignature=MCwCFBEzxwxCPSrWwYj1lsfyDDMKEhMmAhRtDi2klZeDojMK3HBF7xaC3OBj9A\\=\\=\n```\nUsing Maven\n-------------------\nIn your pom.xml you must define the dependencies to Licensius artifacts with:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ero.fortsoft.licensius\u003c/groupId\u003e\n    \u003cartifactId\u003elicensius\u003c/artifactId\u003e\n    \u003cversion\u003e${licensius.version}\u003c/version\u003e\n\u003c/dependency\u003e    \n```\n\nwhere ${licensius.version} is the last licensius version.\n\nYou may want to check for the latest released version using [Maven Search](http://search.maven.org/#search%7Cga%7C1%7Clicensius)\n\nHow to build\n-------------------\nRequirements: \n- [Git](http://git-scm.com/) \n- JDK 7 (test with `java -version`)\n- [Apache Maven 3](http://maven.apache.org/) (test with `mvn -version`)\n\nSteps:\n- create a local clone of this repository (with `git clone https://github.com/decebals/licensius.git`)\n- go to project's folder (with `cd licensius`) \n- build the artifacts (with `mvn clean package` or `mvn clean install`)\n\nAfter above steps a folder _licensius/target_ is created and all goodies are in that folder.\n\nVersioning\n------------\nLicensius will be maintained under the Semantic Versioning guidelines as much as possible.\n\nReleases will be numbered with the follow format:\n\n`\u003cmajor\u003e.\u003cminor\u003e.\u003cpatch\u003e`\n\nAnd constructed with the following guidelines:\n\n* Breaking backward compatibility bumps the major\n* New additions without breaking backward compatibility bumps the minor\n* Bug fixes and misc changes bump the patch\n\nFor more information on SemVer, please visit http://semver.org/.\n\nLicense\n--------------\nCopyright 2015 Decebal Suiu\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this work except in compliance with\nthe License. You may obtain a copy of the License in the LICENSE file, or at:\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on\nan \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the\nspecific language governing permissions and limitations under the License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecebals%2Flicensius","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdecebals%2Flicensius","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecebals%2Flicensius/lists"}