{"id":24953894,"url":"https://github.com/apache/directory-fortress-realm","last_synced_at":"2025-08-08T13:10:29.784Z","repository":{"id":57744878,"uuid":"43539708","full_name":"apache/directory-fortress-realm","owner":"apache","description":"Mirror of Apache Directory Fortress Realm","archived":false,"fork":false,"pushed_at":"2025-03-10T22:48:55.000Z","size":920,"stargazers_count":4,"open_issues_count":1,"forks_count":6,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-03T04:16:53.842Z","etag":null,"topics":["directory","java","network-client","network-server"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":false,"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/apache.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}},"created_at":"2015-10-02T07:00:06.000Z","updated_at":"2025-02-02T16:12:46.000Z","dependencies_parsed_at":"2024-01-25T23:06:01.461Z","dependency_job_id":"cd218ff8-f7f1-4784-8dcc-6017f2f271db","html_url":"https://github.com/apache/directory-fortress-realm","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fdirectory-fortress-realm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fdirectory-fortress-realm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fdirectory-fortress-realm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fdirectory-fortress-realm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/directory-fortress-realm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247714853,"owners_count":20983955,"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":["directory","java","network-client","network-server"],"created_at":"2025-02-03T04:16:30.092Z","updated_at":"2025-08-08T13:10:29.774Z","avatar_url":"https://github.com/apache.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"   Licensed to the Apache Software Foundation (ASF) under one\n   or more contributor license agreements.  See the NOTICE file\n   distributed with this work for additional information\n   regarding copyright ownership.  The ASF licenses this file\n   to you under the Apache License, Version 2.0 (the\n   \"License\"); you may not use this file except in compliance\n   with the License.  You may obtain a copy of the License at\n\n     http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing,\n   software distributed under the License is distributed on an\n   \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n   KIND, either express or implied.  See the License for the\n   specific language governing permissions and limitations\n   under the License.\n\n# README for Apache Fortress Realm\n * Version 3.0.1\n\n-------------------------------------------------------------------------------\n## Table of Contents\n\n * Document Overview\n * About Apache Fortress Realm  \n * Tips for first-time users\n * SECTION 1. Prerequisites\n * SECTION 2. Download \u0026 Install\n * SECTION 3. Instructions for Application Usage\n\n___________________________________________________________________________________\n## Document Overview\n\nThis document contains instructions to download and install the Apache Fortress Realm.  SECTION 3 contains steps to get it working with Apache Tomcat.\n\n___________________________________________________________________________________\n## About Apache Fortress Realm\n\n* Role-Based Access Control security provider to Apache Tomcat.\n\n* Uses Apache Tomcat Realm Interface\n\n* Declarative controls for authentication \u0026 coarse-grained authorization (role check) \n___________________________________________________________________________________\n##  Tips for first-time users\n\n * To use with ApacheDS: **README-QUICKSTART-APACHEDS.md** in **FORTRESS_CORE_HOME** package\n * To use OpenLDAP: **README-QUICKSTART-SLAPD.md** in **FORTRESS_CORE_HOME** package.\n * Tutorial to integrate a Java Web app with Fortress RBAC apis: [README-ENABLE-FORTRESS](https://github.com/shawnmckinney/wicket-sample/blob/master/README-ENABLE-FORTRESS.md).\n * Questions about this software package should be directed to its mailing list:\n   * http://mail-archives.apache.org/mod_mbox/directory-fortress/\n\n-------------------------------------------------------------------------------\n## SECTION 1. Prerequisites\n\nMinimum software requirements (to build):\n * git\n * Java SDK \u003e= 17\n * Apache Maven \u003e= 3.6.3\n\n-------------------------------------------------------------------------------\n## SECTION 2. Download \u0026 Install\n\n1. Download the source.\n\n a. from git:\n```\ngit clone --branch 3.0.1 https://gitbox.apache.org/repos/asf/directory-fortress-realm.git\ncd directory-fortress-realm\n```\n\n b. or download package:\n\n```\nwget http://www.apache.org/dist/directory/fortress/dist/[version]/fortress-realm-3.0.1-source-release.zip\nunzip fortress-realm-[version]-source-release.zip\ncd fortress-realm-[version]\n```\n\n2. Build the source\n\n```\nmvn clean install\n```\n\n3. Now build the javadoc:\n\n```\nmvn javadoc:javadoc\n```\n\n4. View the generated document here: [./target/site/apidocs/overview-summary.html](./target/site/apidocs/overview-summary.html).\n\n-------------------------------------------------------------------------------\n## SECTION 3. Instructions for Application Usage\n\n There are two options for web app usage of the fortress realm:\n\n * **Option 1** requires web apps to be dependent on the fortress realm libs but enables usage of the fortress RBAC programmatic authZ apis.\n It allows multiple realms, each of a different type and version, to be enabled within a single Tomcat instance.\n\n * **Option 2** frees the web app from entanglement with fortress libs, which is easier to manage, but doesn't allow fortress api usage.  It limits to a single realm instance,\n  enabled globally, which might not agree with multitenant requirements.\n\n### Table of Options\n\n|Realm Type|Is Global Security?|Is Declarative?|Is RBAC APIs?|Multiple Realms Supported?|Fortress Dependencies?|\n|:--------:|:-----------------:|:-------------:|:-----------:|:------------------------:|:--------------------:|\n| Option 1 |       No          |      Yes      |     Yes     |          Yes             |         Yes          |\n| Option 2 |       Yes         |      Yes      |     No      |          No              |         No           |\n\n### Option 1. For Single Web Context\n *enable Java EE security for a single web app running under Tomcat*\n * Follow these instructions: [REALM-CONTEXT-SETUP](./REALM-CONTEXT-SETUP.md).\n\n ![Apache Fortress Realm System Architecture](images/fortress-realm-system-arch.png \"Apache Fortress Realm System Architecture\")\n\n-------------------------------------------------------------------------------\n\n### Option 2. For Global Security\n *enable Java EE security for all web apps running under Tomcat*\n * Follow these instructions: [REALM-HOST-SETUP](./REALM-HOST-SETUP.md).\n\n  ![Apache Fortress Realm Host System Architecture](images/fortress-realm-host-system-arch.png \"Apache Fortress Realm Host System Architecture\")\n\n___________________________________________________________________________________\n#### END OF README\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fdirectory-fortress-realm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fdirectory-fortress-realm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fdirectory-fortress-realm/lists"}