{"id":22389886,"url":"https://github.com/entando/connection-config-connector","last_synced_at":"2025-03-26T21:27:31.717Z","repository":{"id":80028231,"uuid":"302372680","full_name":"entando/connection-config-connector","owner":"entando","description":null,"archived":false,"fork":false,"pushed_at":"2020-10-08T14:46:44.000Z","size":40,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-02-01T03:28:00.756Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/entando.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":"2020-10-08T14:46:03.000Z","updated_at":"2020-10-08T14:46:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"44e07d78-0cde-40f9-a7f4-93b663ff5287","html_url":"https://github.com/entando/connection-config-connector","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fconnection-config-connector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fconnection-config-connector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fconnection-config-connector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entando%2Fconnection-config-connector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/entando","download_url":"https://codeload.github.com/entando/connection-config-connector/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245738025,"owners_count":20664206,"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":[],"created_at":"2024-12-05T03:13:31.708Z","updated_at":"2025-03-26T21:27:31.712Z","avatar_url":"https://github.com/entando.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Entando Connection Config Connector\n\n[![Build Status](https://jenkins.entandocloud.com/buildStatus/icon?job=de-connection-config-connector-master)](https://jenkins.entandocloud.com/job/de-connection-config-connector-master/)\n[![Coverage Status](https://coveralls.io/repos/github/entando/connection-config-connector/badge.svg?branch=master)](https://coveralls.io/github/entando/connection-config-connector?branch=master)\n\nThis library is used to integrate with the Entando Connection Config Sidecar. The sidecar exposes an API to handle\nconnection configuration and this library make it possible to integrate with the sidecar without the need to \nimplement the communication to the service.\n\n## Install\n\nAdd the following dependency to your project:\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.entando\u003c/groupId\u003e\n    \u003cartifactId\u003econnection-config-connector\u003c/artifactId\u003e\n    \u003cversion\u003e0.0.1-SNAPSHOT\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nThe library includes the configuration class `org.entando.connectionconfigconnector.config.ConnectionConfigConfiguration`\nand you need to make sure it will be loaded. One way to do that is by using the `@Import` Spring annotation:\n```java\n@SpringBootApplication\n@Import(ConnectionConfigConfiguration.class)\npublic class DemoApplication {\n\n    public static void main(String[] args) {\n        SpringApplication.run(DemoApplication.class, args);\n    }\n}\n```\n\n## Security Level\n\nThis library has two modes or security levels: STRICT and LENIENT. You can choose the security level using the spring\nproperty `entando.plugin.security.level`.\n\n### STRICT\n\nThis is the default security level. On this level, the library does not communicate with the sidecar. Hence, the sidecar\ndoes not need to be deployed when using this level.\n\nOn the Strict security level, only read operations can be performed and the exception `ConnectionConfigException` is \nraised when trying to perform other operations (add, delete, edit).\n\nWhen running on Strict security level, connection config is read from the file system and the root directory is defined\nby the spring property `entando.connections.root`, which has the default value `/etc/entando/connectionconfigs`. Since\nonly read operations are allowed on the strict mode, the files with the configurations should be included manually.\nInside the root directory, there should be one subdirectory for each connection config and each subdirectory must have\na file named `config.yaml`. The yaml file should contain attributes matching the class `ConnectionConfig.java`:\n```yaml\nname: \u003cconnection_name\u003e\nurl: \u003cconnection_url\u003e\nusername: \u003cconnection_username\u003e\npassword: \u003cconnection_password\u003e\nserviceType: \u003cconnection_serviceType\u003e\nproperties:\n  property1: value1\n  property2: value2\n```\n\n### LENIENT\n\nOn this security level the library communicate with the sidecar, so the sidecar needs to be deployed and reachable\nthrough localhost.\n\nWhen using Lenient security level, all operations are supported and translated to HTTP requests on localhost on \nthe port number defined by the Spring property `plugin.sidecar.port`, which has the default value 8084. This is where\nthe sidecar must be running.\n\nTo get more information regarding the sidecar, please check its repository:\nhttps://github.com/entando/entando-plugin-sidecar\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentando%2Fconnection-config-connector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fentando%2Fconnection-config-connector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentando%2Fconnection-config-connector/lists"}