Getting a Token for Use With the API

- LOCATION
- 111 Congress Ave, Suite 500
  Austin, Texas 78701
  United States
- EMAIL
- info@cyberhillpartners.com
- PHONE NUMBER
- +1 (720) 792-0122

Getting a Token for Use With the API

Secret Server

Summary

**Do not use in production environment without professional assistance**

To start using the API you need to get a token. There are a few ways to do this, below is an example of passing a URL, Username and Password. Notice the TOTP One time password is there and optional, if needed.

To view this script on the Cyberhill Github page, click here.

Function Get-SSTokenLocal {
    Param
    (
         [Parameter(Mandatory=$true, Position=0)]
         [string] $URI,
         [Parameter(Mandatory=$true, Position=1)]
         [string] $UserName,
         [Parameter(Mandatory=$true, Position=2)]
         [string] $Password,
         [Parameter(Mandatory=$false, Position=3)]
         [string] $OTP
    )

    $creds = @{
        username = $UserName
        password = $Password
        grant_type = "password"
    };

    $headers = $null
    If ($OTP) {
        $headers = @{
            "OTP" = $OTP
        }
    }

    try
    {
        $response = Invoke-RestMethod "$URI/oauth2/token" -Method Post -Body $creds -Headers $headers;
        return $response;
    }
    catch
    {
        $result = $_.Exception.Response.GetResponseStream();
        $reader = New-Object System.IO.StreamReader($result);
        $reader.BaseStream.Position = 0;
        $reader.DiscardBufferedData();
        $responseBody = $reader.ReadToEnd() | ConvertFrom-Json
        Write-Host "ERROR: ($responseBody.error)"
        return;
    }
}