accesscontroltool - GitLite

KO | EN

gitlite — search

#python #react #ai #typescript #llm #go #rust #deep-learning #java #windows #kubernetes #vue #ios #openai

accesscontroltool

(★ 157)

Rights and roles management for AEM made easy

파일 탐색기

최종 버전 다운로드 (.zip)

- - maven.yml
- - maven-wrapper.properties
- pom.xml
- bnd.bnd
- maximum-sling.bndrun
- minimum-aem.bndrun
- minimum-sling.bndrun
- pom.xml
- suppression.xml
- pom.xml
- pom.xml
- pom.xml
- pom.xml
- bnd.bnd
- pom.xml
- - architectural-overview.png
  - cloud-installation-logs.png
  - configuration-file-structure.png
  - crx-storage.png
  - dump-service.png
  - fragments.png
  - installation-service.png
  - jmx-interface.png
- AdvancedFeatures.md
- ApplyConfig.md
- BestPractices.md
- BuildPackage.md
- Comparison.md
- Configuration.md
- ExternalGroupSyncIms.md
- Installation.md
- Jmx.md
- Migration.md
- - minimum-aem.bndrun
  - pom.xml
- - maximum-sling.bndrun
  - pom.xml
- - minimum-sling.bndrun
  - pom.xml
- pom.xml
.gitignore
LICENSE.txt
mvnw
mvnw.cmd
pom.xml
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/Netcentric/accesscontroltool

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd accesscontroltool

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Maven (Java)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java 프로젝트를 빌드/실행하려면 필요합니다.
Maven mvn 명령어를 쓰기 위한 빌드 도구입니다.

cd accesscontroltool-apps-package

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

mvn clean install

Maven으로 의존성 설치와 빌드를 진행합니다.

✅ BUILD SUCCESS 메시지가 뜨면 성공입니다. target/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Maven Central Version](https://img.shields.io/maven-central/v/biz.netcentric.cq.tools.accesscontroltool/accesscontroltool)](https://central.sonatype.com/artifact/biz.netcentric.cq.tools.accesscontroltool/accesscontroltool-package)
[![License](https://img.shields.io/badge/License-EPL%202.0-red.svg)](https://opensource.org/licenses/EPL-2.0)
[![Build Status](https://github.com/netcentric/accesscontroltool/actions/workflows/maven.yml/badge.svg?branch=develop)](https://github.com/Netcentric/accesscontroltool/actions/workflows/maven.yml)
[![SonarCloud Status](https://sonarcloud.io/api/project_badges/measure?project=Netcentric_accesscontroltool&metric=alert_status)](https://sonarcloud.io/dashboard?id=Netcentric_accesscontroltool)
[![SonarCloud Coverage](https://sonarcloud.io/api/project_badges/measure?project=Netcentric_accesscontroltool&metric=coverage)](https://sonarcloud.io/project/activity?id=Netcentric_accesscontroltool&graph=coverage)

Access Control Tool for Adobe Experience Manager
================================================

The Access Control Tool for Adobe Experience Manager (AC Tool) simplifies the specification and deployment of complex [Access Control Lists in AEM](https://experienceleague.adobe.com/docs/experience-manager-65/administering/security/security.html?lang=en#permissions-in-aem) as well as users and groups.
Instead of existing solutions that build e.g. a content package with actual ACL nodes you can write simple configuration files and deploy them with your content packages. See [comparison to other approaches](docs/Comparison.md) for a comprehensive overview.

Features:

* easy-to-read [Yaml](https://yaml.org/) configuration file format
* run mode support
* automatic installation with install hook
* cleans obsolete ACL entries when configuration is changed
* ACLs can be exported
* management of user's key stores
* stores history of changes
* ensured order of ACLs
* built-in expression language to reduce rule duplication
* creation/update of [external IMS groups](docs/ExternalGroupSyncIms.md)

See also our talk at [adaptTo() 2016](https://adapt.to/2016/en/schedule/ac-tool.html)

# Requirements

The AC Tool requires **Java 11 and AEM 6.5.18** or above (use v3.x for older AEM versions which runs on Java 8 and AEM 6.4 or above) for on-premise installations. Since v2.5.0 **[AEM as a Cloud Service](https://www.adobe.com/marketing/experience-manager/cloud-service.html)** is supported, see [Startup Hook](https://github.com/Netcentric/accesscontroltool/blob/develop/docs/ApplyConfig.md#startup-hook) for details.

It is also possible to run the AC Tool on **Apache Sling 12** or above (ensure system user `actool-service` has `jcr:all` permissions on root). When using the AC Tool with Sling, actions in ACE definitions, encrypted passwords and user's key stores cannot be used. To use the `externalId` attribute, ensure bundle `oak-auth-external` installed (not part of default Sling Starter distribution).

# Installation

The [content package](https://jackrabbit.apache.org/filevault) is available from [the Maven Central repository](https://repo1.maven.org/maven2/biz/netcentric/cq/tools/accesscontroltool/accesscontroltool-package/)

For quick ad hoc testing and getting to know the AC Tool, the easiest is to

* Install the latest version via AEM's package manager
* Create a sample YAML file in CRXDE (e.g. `/apps/actool-test/test.yaml`)
* Apply this config using the UI (see [User Interface](#user-interface) below)

For properly integrating the AC Tool in your own deployment package see [Installation](docs/Installation.md).

# Configuration of the AC Tool

You need to setup [Yaml configuration files](docs/Configuration.md) to specify your users, groups and ACL entries. See also the [best practices](docs/BestPractices.md) for hints on structuring.

There are also some [advanced configuration options](docs/AdvancedFeatures.md) supported such as loops, conditional statements and permissions for anonymous.

# User Interface

There is a [Felix Web Console plugin (at `/system/console/actool`)](docs/ApplyConfig.md#web-console) as well as a [Touch UI console (at `/mnt/overlay/netcentric/actool/content/overview.html`)](docs/ApplyConfig.md#touch-ui) to apply configurations and to inspect previous executions of the tool. Additionally there is a [JMX interface](docs/Jmx.md) for some advanced use cases.

# Applying AC Tool Configurations

Best practice is to apply AC Tool Configurations using the install hook (or startup hook for Cloud Service) during your project's software package installation. See [applying the ACL entries](docs/ApplyConfig.md) for a full list of options.

# Migration to AC Tool

You can easily migrate to AC Tool following [four simple steps](docs/Migration.md).

# Questions

If you have any questions which are still answered after reading the [documentation](docs/) feel free to raise them in the [discussion forum](https://github.com/Netcentric/accesscontroltool/discussions).

# Contributions

Contributions are highly welcome in the form of [issue reports](https://github.com/Netcentric/accesscontroltool/issues), [pull request](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork) or providing help in our [discussion forum](https://github.com/Netcentric/accesscontroltool/discussions).

# Building the packages from source

If needed you can [build the AC Tool yourself](docs/BuildPackage.md).

# License

The AC Tool is licensed under the [Eclipse Public License - v 2.0](LICENSE.txt).