Authenticates and prepares a connection for communicating to the specified Fusion Lifecycle tenant.

Connect-FLC -Tenant <String> -ClientId <String> -ClientSecret <String> -UserId <String> [<CommonParameters>]

Type Name Description Optional
StringTenantThe name of the Fusion Lifecycle tenant, which is usually the first part of the URL to your Fusion Lifecycle Site: https://<Tenant>
StringClientId The Client ID of the registered Forge app is your app’s username required for the two-legged authentication on the Forge Platformno
StringClientSecret The Client Secret is your app’s password and can be found next to the Client ID in the My Apps sectionno
StringUserIdThe e-mail address of a particular user who will perform all the succeeding requests to Fusion Lifecycleno

$true ← on success.
$false ← on failure with an additional property 'Error' containing the Exception/ErrorMessage.

For authenticating through the 2-legged OAuth flow to the Forge Platform, the cmdlet talks to the Fusion Lifecycle -Tenant using a token that gets calculated using the -ClientId and -ClientSecret of the registered Forge app.
Retrieve this sensitive Client ID and Secret credentials of your registered powerFLC app from the Forge portal and make sure the Client ID is whitelisted in your Fusion Lifecycle Configuration.

Because the two-legged authentication token won’t have any information tied to a particular user, FusionLifecycle needs to know via -UserId the e-mail address of a valid user in the system.

When the commandlet could successfully establish a connection to Fusion Lifecycle, the powershell variable $flcConnection is created and lets you communicate to your tenant directly through the Fusion Lifecycle APIs.

Connect to a Fusion Lifecycle tenant using Two-legged authentication

Connect-FLC -Tenant 'previewcoolorange' -ClientId 'nkerZQhAFEgt9f23Jk8aQ6B2NeRaLSjU' -ClientSecret 'w68qUITbY8RTjGCh' -UserId ''

Error handling, analyze why the connection could not be established

$result = Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId ''

if(-not $result) {
   $result.Error #Returns "Authentication to Forge failed!"