Configure O365

Within the App Details section, enter the following details:

  • Location = Outside my corporate network

  • Name = Office 365

  • URL = https://login.microsoftonline.com/login.srf

  • Related Domains: *.login.microsoftonline.com

  • Description = (default)

gateway-saas-01

Within the Single Sign On section, enter the following details:

  • Sign assertion = Assertion

  • Assertion URL = https://login.microsoftonline.com/login.srf

  • Relay State = https://login.microsoftonline.com/login.srf

  • Audience = urn:federation:MicrosoftOnline

  • Name ID Format = Persistent

  • Name ID = Active Directory GUID

  • Advanced Attributes: URI

    Attribute Name: IDPEmail

    Attribute Format: Unspecified

    Attribute Value: Email

Note:

  • The Login URL in this page is used “$uri” in domain federation.
  • The EntityID in the SAML Metadata (xml file) is used as “$IssuerUri” in domain federation.

gateway-saas-02

O365 SaaS Application Federation to Citrix Gateway

PowerShell commands to configure FEDERATED mode on Microsoft Cloud:

Microsoft MSOnline Module must be installed

  • PS> Install-Module AzureAD -Force

PS> Import-Module AzureAD -Force

PS> Install-Module MSOnline -Force

PS> Import-module MSOnline -Force

PS> connect-msolservice

Note: A Microsoft Cloud Account must be used to connect to msolservice. For example, admin.user@onmicrosoft.com.

Configure the Federation settings unique to the Citrix Gateway Customer subscription:

  • PS> $dom = "ad-domain.com"

Note: The ad-domain.com namespace is the user authentication domain.

  • PS> $IssuerUri = "https://citrix.com/[customerID]"

  • PS> $fedBrandName = "WORKSPACESECURITY"

  • PS> $logoffuri = "https://app.netscalergateway.net/cgi/logout"

  • $uri = "https://app.netscalergateway.net/ngs/[customerID]/saml/login?APPID=[AppID]”

Note:

  • The customerID can be found in;

    • Citrix Cloud > Identity and Access Management > API Access.
    • Citrix Cloud > Citrix Gateway Service > Add a Web/SaaSApp > Single sign on > SAML Metadata file > EntityID.
  • $uri can be copied from Citrix Gateway Service > Add a Web/SaaSApp > Single sign on > Login URL or from SAML Metadata > Location.

Supply the SAML IdP certificate from Citrix Gateway:

  • PS> $cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2("c:\cert\saml_idp.crt")
  • PS> $certData = [system.convert]::tobase64string($cert.rawdata)

Execute the PS string to complete the Federation to Citrix Gateway:

  • PS> Set-MsolDomainAuthentication -DomainName $dom –federationBrandName $fedBrandName -Authentication Federated -PassiveLogOnUri $uri -LogOffUri $logoffuri -SigningCertificate $certData -IssuerUri $IssuerUri -PreferredAuthenticationProtocol SAMLP

Validate the following domain federation and settings are complete:

Get-MsolDomainFederationSettings -DomainName <String>

Office 365 Suite Applications

  • Outlook https://outlook.office365.com/

  • OneDrive for Business https://[customerid].sharepoint.com/

  • Word https://office.live.com/start/Word

  • Excel https://office.live.com/start/Excel

  • PowerPoint https://office.live.com/start/PowerPoint

  • OneNote https://www.onenote.com/

  • SharePoint https://[customerid].sharepoint.com/

  • Teams https://teams.microsoft.com/

  • Yammer https://www.yammer.com/office365

  • Dynamics 365 https://[customerid].dynamics.com/

  • Flow https://flow.microsoft.com/


Azure PowerShell Module Reference

Azure PowerShell Command Reference

Deploy Office 365 Directory Synchronization in Microsoft Azure