Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# Change Log

All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com), and this project adheres to [Semantic Versioning](https://semver.org).

## [1.0.0] - 2025-12-31

This is the first official release of _HelloID-Conn-Prov-Target-MicrosoftTeams-Voip_. This release is based on template version _v3.1.0_.

### Added

- Comprehensive README documentation describing connector functionality
- Detailed prerequisites section including:
- Microsoft Teams PowerShell module version requirement (5.7.1 or higher)
- On-Premises agent requirement
- Microsoft Entra ID App Registration setup instructions
- Required API permissions (Organization.Read.All)
- Microsoft Entra ID role assignment instructions (Teams Communications Administrator)
- Introduction section explaining connector purpose and key functionalities:
- Correlation-based user management
- CallingLineIdentity policy management based on department ID
- Enterprise Voice control
- Teams Phone license validation
- Implementation complexity section explaining:
- Why customization is required for each implementation
- Framework approach and extensibility options
- Implementation planning considerations
- Available Examples section documenting:
- Main branch standard connector (recommended starting point)
- Example-v1 folder with legacy connector for reference
- AdvancedExample folder with database integration example
- Remarks section with detailed explanations:
- CallingLineIdentity mapping to department IDs
- Teams Phone license requirements
- Enterprise Voice settings management
- Certificate-based authentication details
- No account creation support clarification
- Authentication method limitations (certificate only)
- Development resources section with:
- List of Microsoft Teams PowerShell cmdlets used
- Links to Microsoft documentation
- Connection settings documentation for certificate-based authentication
- Correlation configuration with example mapping
- Warning banner about implementation complexity and customization requirements

### Changed

- Updated connector title to reflect Microsoft Teams VoIP/Direct Routing functionality
- Updated correlation configuration to use UserPrincipalName instead of generic EmployeeNumber
- Updated supported features table to show only Create and Update actions (removed Enable, Disable, Delete)
- Updated connection settings to reflect certificate-based authentication requirements (removed generic username/password/baseurl)

### Deprecated

### Removed

- Generic placeholder text from template
- Unused API endpoints section (replaced with PowerShell cmdlets)
- Template example remarks that weren't applicable
359 changes: 253 additions & 106 deletions README.md

Large diffs are not rendered by default.

93 changes: 41 additions & 52 deletions configuration.json
Original file line number Diff line number Diff line change
@@ -1,57 +1,46 @@
[
{
"key": "MicrosoftEntraIDTenantId",
"type": "input",
"defaultValue": "",
"templateOptions": {
"label": "Microsoft Entra ID Tenant ID",
"placeholder": "1234567-2538-4922-80e2-b890abcde",
"description": "The ID of the Tenant in Microsoft Entra ID",
"required": true
}
{
"defaultValue": "",
"key": "TenantID",
"templateOptions": {
"description": "",
"label": "App Registration Directory (tenant) ID",
"placeholder": "615g75e2-0v74-4a3c-6gaf-241t1q4m7f54",
"required": true
},
{
"key": "MicrosoftEntraIDAppId",
"type": "input",
"defaultValue": "",
"templateOptions": {
"label": "Microsoft Entra ID App ID",
"placeholder": "1234567-2538-4922-80e2-b890abcde",
"description": "The ID of the App Registration in Microsoft Entra ID with the Microsoft Teams permissions to the specfied organization",
"required": true
}
"type": "input"
},
{
"defaultValue": "",
"key": "AppId",
"templateOptions": {
"description": "",
"label": "App Registration Application (client) ID",
"placeholder": "9c12a9b1-34c5-678d-ac34-8a890100d46d",
"required": true
},
{
"key": "MicrosoftEntraIDAppSecret",
"type": "input",
"defaultValue": "",
"templateOptions": {
"label": "Microsoft Entra ID App Secret",
"type": "password",
"placeholder": "1234567-2538-4922-80e2-b890abcde",
"description": "The Secret of the App Registration in Microsoft Entra ID with the Microsoft Teams permissions to the specfied organization",
"required": true
}
},
{
"key": "OnlySetPhoneNumberWhenEmpty",
"type": "checkbox",
"defaultValue": true,
"templateOptions": {
"label": "Only Set Phone Number When Empty",
"placeholder": "1234567-2538-4922-80e2-b890abcde",
"description": "When toggled, the Phone Number will only be set if there currently is no value set",
"required": false
}
},
{
"key": "isDebug",
"type": "checkbox",
"defaultValue": false,
"templateOptions": {
"label": "Toggle debug logging",
"description": "When toggled, debug logging will be displayed",
"required": false
}
"type": "input"
},
{
"key": "AppCertificateBase64String",
"type": "input",
"defaultValue": "",
"templateOptions": {
"label": "App Registration Certificate Base 64 String",
"type": "password",
"placeholder": "WFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFg==",
"required": true
}
},
{
"key": "AppCertificatePassword",
"type": "input",
"defaultValue": "",
"templateOptions": {
"label": "App Registration Certificate Password",
"type": "password",
"placeholder": "P@ssw0rd!",
"required": true
}
}
]
Loading