https://github.com/monocloud/management-dotnet
MonoCloud Management SDK for .NET - programatically manage apps, policies, configurations, users, and groups via the MonoCloud Management APIs
https://github.com/monocloud/management-dotnet
api csharp dotnet monocloud sdk
Last synced: 3 months ago
JSON representation
MonoCloud Management SDK for .NET - programatically manage apps, policies, configurations, users, and groups via the MonoCloud Management APIs
- Host: GitHub
- URL: https://github.com/monocloud/management-dotnet
- Owner: monocloud
- License: mit
- Created: 2025-12-03T06:39:27.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-03-10T09:07:20.000Z (4 months ago)
- Last Synced: 2026-03-10T16:32:24.909Z (4 months ago)
- Topics: api, csharp, dotnet, monocloud, sdk
- Language: C#
- Homepage: https://www.monocloud.com
- Size: 7.51 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
## Introduction
**MonoCloud Management SDK for .NET – programmatically manage apps, policies, configurations, users, and groups via the MonoCloud Management APIs.**
[MonoCloud](https://www.monocloud.com?utm_source=github&utm_medium=management_dotnet) is a modern, developer-friendly Identity & Access Management platform.
This SDK provides a full-featured, typed .NET client for interacting with the **MonoCloud Management APIs**, allowing you to automate tenant administration programmatically.
## 📘 Documentation
- **Documentation:** [https://www.monocloud.com/docs](https://www.monocloud.com/docs?utm_source=github&utm_medium=management_dotnet)
- **Management API SDK Docs:** [https://www.monocloud.com/docs/apis/management](https://www.monocloud.com/docs/apis/management?utm_source=github&utm_medium=management_dotnet)
- **API Reference:** [https://monocloud.github.io/management-dotnet](https://monocloud.github.io/management-dotnet?utm_source=github&utm_medium=management_dotnet)
## Supported Platforms
This SDK supports applications targeting:
- **.NET Standard 2.0** (recommended for maximum compatibility)
- **.NET Framework 4.6.1+**
- **.NET 6.0+** and later
## 🚀 Getting Started
### Requirements
- A **MonoCloud tenant**
- A **Management API key** with appropriate permissions
### Installation
```powershell
Install-Package MonoCloud.Management
# or
dotnet add package MonoCloud.Management
```
### Usage
The SDK closely mirrors the REST API structure — clients are organized by resource areas (clients, resources, users, groups, etc.).
```csharp
var managementClient = new MonoCloudManagementClient(new MonoCloudConfig("https://", ""));
```
> [!CAUTION]
> Do not hardcode your API key. It is recommended to load it from an environment variable or a secure configuration manager like appsettings.json. For modern .NET applications, it is best practice to use Dependency Injection to manage the client lifecycle and configuration securely via the [`AddMonoCloudManagementClient`](https://github.com/monocloud/management-dotnet/blob/main/src/management/src/MonoCloudManagementServiceExtensions.cs) service extension.
#### Example - Get all clients
```csharp
var result = await managementClient.Clients.GetAllClientsAsync(
page: 1,
size: 10,
filter: "dashboard",
sort: "name:1"
);
```
Explore further operations at [https://www.monocloud.com/docs](https://www.monocloud.com/docs?utm_source=github&utm_medium=management_dotnet)
## 🤝 Contributing & Support
### Issues & Feedback
- Use **GitHub Issues** for bug reports and feature requests.
- For tenant or account-specific help, contact MonoCloud Support through your dashboard.
### Security
Do **not** report security issues publicly. Please follow the contact instructions at: [https://www.monocloud.com/contact](https://www.monocloud.com/contact?utm_source=github&utm_medium=management_dotnet)
## 📄 License
Licensed under the **MIT License**. See the included [`LICENSE`](https://github.com/monocloud/management-dotnet/blob/main/LICENSE) file.