SP SSO Configuration

Once Cloud9 has confirmed that your SSO settings have been configured based on the federation metadata you provided, you will receive a link to our metadata. At this point, you should configure this within your SAML environment.

Find your Firm ID

In the received data, you will find your unique Firm ID, which appears in the link as shown below:

https://c9portal.xhoot.com/c9portalws/ws.php?v2=true&auth=login-e61c1f1bef13cda3e06e5011e264538&cmd=metadata&action=sso&client=<FIRM-ID>

  • Replace <Firm-ID> with your firm ID value.

Updating the Cloud9 Configuration

To enable SP-initiated SSO, you must update the following sections of the C9TraderProps.ini file, located in:

%localappdata%\Cloud9_Technologies\C9Trader\other\C9TraderProps.ini

  • Edit the file to set the following values:
    • FirmId= — Enter your unique Firm ID.
    • SpInitiatedSsoEnabled= — Set this value to True.

Deployment via PowerShell

If you have an internal deployment tool, you can use the PowerShell script below to apply these changes across your environment:

$filePath = "$env:LOCALAPPDATA\Cloud9_Technologies\C9Trader\other\C9TraderProps.ini"

if (-Not (Test-Path -Path $filePath)) {
    Write-Host "The file C9TraderProps.ini does not exist at the specified path." -ForegroundColor Red
    exit 1
}

$entriesToUpdate = @{
    "FirmId"                  = ""
    "SpInitiatedSsoEnabled"   = "True"
}

$fileContent = Get-Content -Path $filePath

$updatedContent = $fileContent | ForEach-Object {
    $line = $_
    foreach ($key in $entriesToUpdate.Keys) {
        if ($line -match "^\s*${key}\s*=") {
            $line = "$key=$($entriesToUpdate[$key])"
        }
    }
    $line
}

$updatedContent | Set-Content -Path $filePath -Encoding UTF8

Write-Host "The file C9TraderProps.ini has been updated successfully with the specified values." -ForegroundColor Green