{"id":16085695,"url":"https://github.com/iamraphson/java-dumb-passwords","last_synced_at":"2025-10-22T10:51:19.261Z","repository":{"id":57729332,"uuid":"67448013","full_name":"iamraphson/java-dumb-passwords","owner":"iamraphson","description":"Guard your users against entering dumb passwords in your java or JavaEE apps","archived":false,"fork":false,"pushed_at":"2016-09-14T22:02:18.000Z","size":57,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-07T22:10:54.136Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iamraphson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-09-05T20:09:23.000Z","updated_at":"2016-09-15T08:20:29.000Z","dependencies_parsed_at":"2022-09-10T23:40:54.303Z","dependency_job_id":null,"html_url":"https://github.com/iamraphson/java-dumb-passwords","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/iamraphson/java-dumb-passwords","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2Fjava-dumb-passwords","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2Fjava-dumb-passwords/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2Fjava-dumb-passwords/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2Fjava-dumb-passwords/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iamraphson","download_url":"https://codeload.github.com/iamraphson/java-dumb-passwords/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamraphson%2Fjava-dumb-passwords/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280424212,"owners_count":26328462,"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","status":"online","status_checked_at":"2025-10-22T02:00:06.515Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-10-09T13:09:00.445Z","updated_at":"2025-10-22T10:51:19.232Z","avatar_url":"https://github.com/iamraphson.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# java-dumb-passwords\n\u003e #### Guard your users from security problems by preventing them from having dumb passwords\n\n### Introduction\n\nThis Artifact can be used to verify **the user provided password is not one of the top 10,000 worst passwords** as analyzed by a respectable IT security analyst. Read about all [here](https://xato.net/10-000-top-passwords-6d6380716fe0#.473dkcjfm), [here(wired)](http://www.wired.com/2013/12/web-semantics-the-ten-thousand-worst-passwords/) or [here(telegram)](http://www.telegraph.co.uk/technology/internet-security/10303159/Most-common-and-hackable-passwords-on-the-internet.html)\n\n# Installation\n\n## Prerequisites\n\n- Java version Oracle JDK 7, 8 or OpenJDK 7\n\n### Maven\nInclude the following in your `pom.xml` for Maven:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.unicodelabs\u003c/groupId\u003e\n    \u003cartifactId\u003ejava-dumb-passwords\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n###Jar-File\nYou can also download the jar file from the latest release on the [releases page](https://github.com/iamraphson/java-dumb-passwords/releases).\n\n## Usage\nA DumbPassword class provides one public method for checking dumb passwords. Instantianting the class is as given below:\n\n```java\nfinal DumbPassword dumbPasswords = new DumbPassword();\n```\n## API\n#### dumbPasswords.checkPassword(string) =\u003e true or false\nCheck if the string provided, representing the user's proposed submitted password is not one of the\n**top 10,000 worst passwords** users use. returns `true` if the password is one of them and `false` if the password is not.\n```java\ntry {\n    if(dumbPasswords.checkPassword(\"gfdgfgghjgjghgk\")){\n        System.out.println(\"This password is just too common. Please try another!\");\n    } else {\n        //This password is awesome!\n        //This user SMART! Give them the Major key! #takeit!!\n        System.out.println(\"This password is awesome\");\n    }\n} catch (IOException ex) {\n    System.out.println(ex.getMessage());\n} catch (IsNullException ex) {\n    System.out.println(ex.getMessage());\n}\n ```\n# Example\nHere is an example\n\n```java\npackage com.unicodelabs.jdp.core.example;\n\nimport com.unicodelabs.jdp.core.DumbPassword;\nimport com.unicodelabs.jdp.core.exceptions.IsNullException;\nimport java.io.IOException;\n\n/**\n *\n * @author Raphson\n */\npublic class DumbPasswordClient {\n    public static void main(String[] args) {\n        DumbPassword dumbPasswords = new DumbPassword();\n        try {\n            if(dumbPasswords.checkPassword(\"gfdgfgghjgjghgk\")){\n                System.out.println(\"This password is just too common. Please try another!\");\n            } else {\n                //This password is awesome!\n                //This user SMART! Give them the Major key! #takeit!!\n                System.out.println(\"This password is awesome\");\n            }\n        } catch (IOException ex) {\n            Logger.getLogger(App.class.getName()).log(Level.SEVERE, null, ex);\n        } catch (IsNullException ex) {\n           Logger.getLogger(App.class.getName()).log(Level.SEVERE, null, ex);\n        }\n    }\n}\n```\n## Contributing\n\nPlease feel free to fork this package and contribute by submitting a pull request to enhance the functionalities.\n\n\n## Security Vulnerabilities\n\nIf you discover a security vulnerability within Java-dumb-passwords java library , please send an e-mail to Ayeni Olusegun at nsegun5@gmail.com. All security vulnerabilities will be promptly addressed.\n\n## How can I thank you?\n\nWhy not star the github repo? I'd love the attention! Why not share the link for this repository on Twitter or HackerNews? Spread the word!\n\nDon't forget to [follow me on twitter](https://twitter.com/iamraphson)!\n\nThanks!\nAyeni Olusegun.\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamraphson%2Fjava-dumb-passwords","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamraphson%2Fjava-dumb-passwords","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamraphson%2Fjava-dumb-passwords/lists"}