MagicDraw and NoMagic Teamwork Cloud Connectors Configuration

Basic Authentication/HTTPS

Example of a CATSmmConfig.json file declaring a NoMagic Teamwork Cloud repository:

{
    "repositoryConfigurations": [
   
      {
            "id": "/noMagicTeamWorkCloud19",
            "title": "NoMagic Teamwork Cloud on TWCServerName",
            "typeUri":  "http://www.3ds.com/vocabularies/syc/type/NoMagicTeamworkCloud",
            "address":  "http://TWCServerName:port",           
            "description": ""           
      } 
    ]
}

Parameter	Description
id	Unique identifier of the NoMagic Teamwork Cloud server. Must not contain blank space.
title	Title of the NoMagic Teamwork Cloud.
typeUri	Cannot be customized. The value must be: http://www.3ds.com/vocabularies/syc/type/NoMagicTeamworkCloud
address	There are two possible addresses: https://<hostname or ipaddress>:8111 IP address hostname of the server and the 8111 port Default port on NoMagic Teamwork Cloud must be specified regarding its installation.
description	Can be customized.

Sign-On Authentication/SAML

For a Sign-On authentication, you must configure both 3DEXPERIENCE and the Teamwork Cloud server.

3DEXPERIENCE Configuration

In the CATSmmConfig.json file, you must add the following SingleSignOn parameters:

  {
         "id": "/noMagicTeamWorkCloudServer ",
         "title": "Teamwork Cloud SAML",
         "typeUri": "http://www.3ds.com/vocabularies/syc/type/NoMagicTeamworkCloud",
         "address": " https://<mytwcserver>:8111",
         "description": "",
          "parameters": {
"singleSignOnEnable": "true",
"singleSignOnAuthorizeUrl" : "https://< mytwcserver>:8555/authentication/authorize",
"singleSignOnRedirectUrl":"https://<my3DEXPServer>/3DSpace/syc/api/sso/v1/res<My TWC Server id>
  	}
}

Parameters	Description
singleSignOnEnable	The parameter indicates that the current Teamwork Cloud server uses SAML/SSO authentication
singleSignOnAuthorizeUrl	Url of the login page of your TWC server. Replace <mytwcserver> by the IP address or the hostname with a domain of your TWC server.
singleSignOnRedirectUrl	https://<my3DEXPServer>/3DSpace/syc/api/sso/v1/res<My TWC Server id> Replace <my3DEXPServer> by the hostname of the 3DEXPERIENCE configured with SSO/SAML. Replace <My TWC Server id> by the id in the configuration of the current TWC server configured with SSO/SAML: "/noMagicTeamWorkCloudServer ". Example:https://<my3DEXPServer>/3DSpace/syc/api/sso/v1/res/noMagicTeamWorkCloudServer

Teamwork Cloud Server Configuration

In the configuration file of the TeamWork Cloud authentication server, you must add the 3DEXPERIENCE server path (https://<my3DEXPServer>/3DSpace/syc/api) to the list of URLs that are allowed by the Authentication Server.

1. Open the folder containing the Authentication Server configuration file of Teamwork Cloud: <Teamwork Cloud Installation Directory>\AuthServer\config
2. With admin privileges, open this file for edit: authserver.properties
3. Locate the key authorizing URL for authentication authentication.redirect.uri.whitelist
4. Add your URL to the list of authorized URL. Example:

   authentication.redirect.uri.whitelist=https://<my twcserver>:8443/webapp/,https:// <my twcserver>:8111/,https://md_redirect, https://<my3DEXPServer>/3DSpace/syc/api

   Note:

   • Replace <my3DEXPServer> by the valid hostname (with domain or IP address) of your 3DEXPERIENCE server.
   • In this list, include all the 3DEXPERIENCE servers that use this Teamwork Cloud server and SSO/SAML.

5. Restart the three Teamwork Cloud services.

   For more information, see the Teamwork Cloud documentation:

   • Starting TWCloud on Windows
   • Post-Install Configuration