icinga-powershell-framework/lib/apis/Get-IcingaDirectorSelfServiceTicket.psm1

<#
.SYNOPSIS
   Will fetch the ticket for certificate signing by using the Icinga Director
   Self-Service API
.DESCRIPTION
   Use the Self-Service API of the Icinga Director to connect to it and fetch the
   ticket to sign Icinga 2 certificate requests
.FUNCTIONALITY
   Fetches the ticket for certificate signing form the Icinga Director Self-Service API
.EXAMPLE
   PS>Get-IcingaDirectorSelfServiceTicket -DirectorUrl 'https://example.com/icingaweb2/director -ApiKey 457g6b98054v76vb5490ß276bv0457v6054b76;
.PARAMETER DirectorUrl
   The URL pointing directly to the Icinga Web 2 Director module
.PARAMETER ApiKey
   The host key to authenticate against the Self-Service API
.INPUTS
   System.String
.OUTPUTS
   System.Object
.LINK
   https://github.com/Icinga/icinga-powershell-framework
#>

function Get-IcingaDirectorSelfServiceTicket()
{
   param(
      $DirectorUrl,
      $ApiKey      = $null
   );

   if ([string]::IsNullOrEmpty($DirectorUrl)) {
      Write-IcingaConsoleError 'Unable to fetch host ticket. No Director url has been specified';
      return;
   }

   if ([string]::IsNullOrEmpty($ApiKey)) {
      Write-IcingaConsoleError 'Unable to fetch host ticket. No API key has been specified';
      return;
   }

   [string]$url = Join-WebPath -Path $DirectorUrl -ChildPath ([string]::Format('/self-service/ticket?key={0}', $ApiKey));

   $response = Invoke-WebRequest -Uri $url -UseBasicParsing -Headers @{ 'accept' = 'application/json'; 'X-Director-Accept' = 'application/json' } -Method 'POST';

   if ($response.StatusCode -ne 200) {
      throw $response.Content;
   }

   $JsonContent = ConvertFrom-Json -InputObject $response.Content;

   return $JsonContent;
}