{"id":19241973,"url":"https://github.com/jaxelr/activedirectory","last_synced_at":"2025-04-21T09:32:33.215Z","repository":{"id":36398929,"uuid":"167811708","full_name":"Jaxelr/ActiveDirectory","owner":"Jaxelr","description":"Service that queries the Active Directory LDAP","archived":false,"fork":false,"pushed_at":"2025-04-17T15:12:08.000Z","size":368,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-18T05:55:06.151Z","etag":null,"topics":["active","carter","directory","dotnet","dotnet-core"],"latest_commit_sha":null,"homepage":"","language":"C#","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/Jaxelr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2019-01-27T13:26:29.000Z","updated_at":"2025-04-17T15:12:12.000Z","dependencies_parsed_at":"2023-01-17T01:08:13.434Z","dependency_job_id":"be7ac8e1-8b31-4331-a67f-d1c7dae42ddd","html_url":"https://github.com/Jaxelr/ActiveDirectory","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaxelr%2FActiveDirectory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaxelr%2FActiveDirectory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaxelr%2FActiveDirectory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaxelr%2FActiveDirectory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jaxelr","download_url":"https://codeload.github.com/Jaxelr/ActiveDirectory/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250032168,"owners_count":21363785,"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":["active","carter","directory","dotnet","dotnet-core"],"created_at":"2024-11-09T17:13:04.608Z","updated_at":"2025-04-21T09:32:33.159Z","avatar_url":"https://github.com/Jaxelr.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Active Directory Service\n\nThis web service is an http wrapper over basic LDAP calls to the Microsoft Active Directory service, I mostly use it on clients for quick onsite domain discovery.\n\n| Ci  | Status | Branch |\n| :---: | :---: | :---: |\n| Azure Pipelines | [![Build Status][azure-main-img]][azure-main] | master |\n| Github Actions | [![.NET][github-main-img]][github-main] | master |\n\n\n## Known Challenges \u0026 Issues\n\nSome requests to the LDAP can be costly and take a few seconds, to mitigate this scenario an in-memory cache has been included to help with recurring requests.\n\n- Use https for prod usage, since the content of these operations is highly sensitive in nature.\n\n## Configurations\n\nSome configurations that are included on the appsettings are:\n\n1. Domains - Optional: if left empty, it will pick the current domain where the service is running. If multiple domains are defined on the Domains array, the endpoint will make requests to all of them. This was a very specific scenario that a client had.\n1. Addresses - Optional: if left empty the current host is selected. Urls defined here, will be used as endpoints on the open ui page for validation.\n1. Route Definition - Required: These values are attached to the openapi declaration and are needed for the defined metadata info\n   1. Route Suffix - The path where the swagger json will be shown.\n   1. Version - The swagger.json file version.\n1. Cache Configurations - Required: Cache Enabled flag that will enable/disable the cache. If enabled, the following keys must be populated.\n   1. Cache Max Size - the maximum size in bytes of each cached response\n   1. Cache Timespan - the time in seconds that the value will be kept alive on the cache store\n   1. Cache Enabled - boolean to activate or deactivate cache on startup\n\nThe current appsettings.json can be configured manually:\n\n```json\n{\n  \"Serilog\": {\n    \"Using\": [ \"Serilog.Sinks.Console\" ],\n    \"MinimumLevel\": \"Information\",\n    \"WriteTo\": [\n      { \"Name\": \"Console\" }\n    ],\n    \"Enrich\": [ \"FromLogContext\", \"WithMachineName\", \"WithThreadId\" ],\n  },\n  \"AllowedHosts\": \"*\",\n  \"AppSettings\": {\n    \"Cache\": {\n      \"CacheTimespan\": 60,\n      \"CacheMaxSize\": 2048,\n      \"CacheEnabled\": true\n    },\n    \"RouteDefinition\": {\n      \"RouteSuffix\": \"/swagger\",\n      \"Version\": \"v1\"\n    },\n    \"Domains\": [\n      \"\"\n    ],\n    \"Addresses\": [\n      \"\"\n    ]\n  }\n}\n```\n\n## Health Check Feature\n\nThe endpoint of root/healthcheck for each requests includes a json heartbeat to determine if the service is online. This was done using the library of [Microsoft.Extensions.Diagnostics.HealthChecks](https://github.com/dotnet/aspnetcore/tree/main/src/HealthChecks) for more information check the github repo.\n\n## OpenApi\n\nThe OpenApi version used is Version 3.0.1\n\n## Dependencies \u0026 Libraries\n\nThis project targets net 9.0. For previous versions, check the tags. The following oss libraries are used on this repo as dependencies:\n\n- [Carter](https://github.com/CarterCommunity/Carter)\n- [Xunit](https://github.com/xunit/xunit)\n- [Swashbuckle.AspNetCore](https://github.com/domaindrivendev/Swashbuckle.AspNetCore)\n- [Serilog.AspNetCore](https://github.com/serilog/serilog-aspnetcore/)\n\n[github-main-img]: https://github.com/Jaxelr/ActiveDirectory/actions/workflows/ci.yml/badge.svg\n[github-main]: https://github.com/Jaxelr/ActiveDirectory/actions/workflows/ci.yml\n[azure-main-img]: https://dev.azure.com/jaxelr0433/ActiveDirectoryService/_apis/build/status/Jaxelr.ActiveDirectory?branchName=master\n[azure-main]: https://dev.azure.com/jaxelr0433/ActiveDirectoryService/_build/latest?definitionId=2\u0026branchName=master\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaxelr%2Factivedirectory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaxelr%2Factivedirectory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaxelr%2Factivedirectory/lists"}