Réserver une Démo
Pré. Proc.

Pro Cloud Server utilisant IIS (facultatif)

Cette rubrique décrit l'utilisation d'Internet Information Server (IIS) de Microsoft pour remplacer le serveur Web intégré du Pro Cloud Server. IIS ne doit être utilisé que sous certaines conditions.

Arrière plan

La possibilité d'utiliser IIS a été introduite dans une première version de Sparx Systems Cloud Services (le produit avant le Pro Cloud Server ) pour permettre aux utilisateurs d' Enterprise Architect d'implémenter une forme de base d'authentification unique (bien que l' prompt pour les informations d'identification de l'utilisateur n'était pas complètement éliminé en utilisant cette méthode).

Dans la version 3 de Pro Cloud Server , la prise en support native de Windows Actif Directory et de l'authentification unique OpenID a été ajoutée, offrant une méthodologie d'authentification unique plus intégrée, robuste et sécurisée.

Limites

La principale limitation de l'utilisation d'IIS au lieu du serveur Web PCS intégré est que des fonctionnalités telles que le serveur de licences flottantes et les intégrations SBPI ne fonctionneront pas lorsque les utilisateurs Enterprise Architect se connectent via IIS. Les ports IIS ne prennent pas non plus en support l'utilisation de 'Pro Fonctionnalités ' telles que l'accès OSLC et WebEA . Fondamentalement, la connexion IIS permet uniquement aux clients Enterprise Architect de lire les données d'un référentiel.

Recommandations

Compte tenu des informations ci-dessus, maintenant Sparx Systems ne recommanderait désormais l'utilisation d'IIS que lorsque les utilisateurs :

  • Utilisez une version de Pro Cloud Server antérieure à la v3
  • N'utilisez pas le composant Floating License Server
  • N'utilisent pas les intégrations SBPI
  • N'utilisent pas la fonctionnalité d'authentification unique PCS native

Configuration

Pour configurer IIS pour héberger le Pro Cloud Server , vous devez d'abord définir le fichier SparxCloudLink.sseap pour faire référence au Pro Cloud Server , puis dans Windows , ouvrez le gestionnaire des services d'information Internet (IIS) et configurez-le pour envoyer des demandes au module approprié. . Selon vos préférences, vous pouvez choisir soit un module HTTP, soit un module ISAPI.

Avant de configurer HTTP ou ISAPI, ces paramètres doivent être définis dans IIS :

  • Paramètres du pool d'applications
  • Fonctionnalité de fonctionnalité
Pour une configuration HTTPS sécurisée (facultatif) :
  • Configurer un certificat
  • Configurer HTTPS

Paramètres de configuration

Avant de configurer votre module HTTP ou module ISAPI, vous devez d'abord vérifier que le fichier SSProCloud.config pour le service est configuré comme requis, et note le Port utilisé afin que vous puissiez le spécifier lorsque vous continuez à définir le fichier SparxCloudLink.sseap pour se référer au Pro Cloud Server .

Le chemin du répertoire contenant l'ISAPI .dll aussi contient le fichier de configuration SparxCloudLink.sseap.

Le chemin doit ressembler à cet exemple :

C:\Program Files (x86)\ Sparx Systems \ Pro Cloud Server \ISAPI

Modifiez ce fichier dans un éditeur de texte, exécuté en tant qu'administrateur.

Le contenu par défaut est :

[ cloud ]

serveur=hôte local

port=803

serveur:

L'adresse pour rechercher la machine exécutant le Pro Cloud Server . Dans la plupart des cas, il est préférable d' exécuter le module HTTP et le Pro Cloud Server sur la même machine. Dans ce cas, la valeur par défaut de valeur peut être utilisée. Si le Pro Cloud Server s'exécute sur une autre machine, utilisez l'adresse IP ou le nom du serveur sur lequel le service s'exécute.

Port:

Le port sur lequel le Pro Cloud Server écoute les demandes d'administration. Par défaut, cela prend la valeur 803, mais cela doit être référencé par rapport à la configuration de votre service dans le fichier SSProCloud.config.

Paramètres facultatifs

Ces points sont facultatifs. À des fins de test, vous préférerez peut-être laisser ces modifications jusqu'à ce que les problèmes avec IIS soient résolus.

  1. Dans le fichier SSProCloud.config, supprimez toutes les références aux ports autres que le port d'administration (803 par défaut). En d'autres termes, supprimez les entrées entre crochets (…) du fichier de configuration.
  2. Enregistrez le fichier SSProCloud.config.
  3. Redémarrez le service.

Paramètres du pool d'applications

HTTP ou ISAPI nécessiteront un pool d'applications 32 bits et non du code géré. Cette illustration montre les paramètres des applications 32 bits dans la vue Paramètres avancés des pools d'applications IIS.

The settings for 32-bit applications in the IIS Application Pools Advanced Settings view.

Fonctionnalité

Cette illustration montre le chemin d'accès et le 'Site Web par défaut | Mappages du gestionnaire pour permettre l'exécution du script.

This illustration shows the access path and the 'Default Web Site | Handler' mappings to permit Script Execution.

Configuration d'un certificat

Pour exécuter le service HTTPS, vous devez configurer un certificat de sécurité dans IIS. Dans le gestionnaire IIS :

  1. Sous "Connexions", sélectionnez la connexion racine (nom de la machine).
  2. Double-cliquez sur l'icône 'Certificats de serveur'.
  3. Cliquez sur "Créer un certificat auto-signé".
  4. Spécifiez un nom simple et convivial pour le certificat.
In order to run the HTTPS service you must set up a security certificate in IIS.

Configurer HTTPS

Pour définir les liaisons via lesquelles HTTPS fonctionnera, vous devez inclure un port et un certificat dans les liaisons du site.

Dans le gestionnaire IIS :

  • Sous "Connexions", sélectionnez l'option "Site Web par défaut"
  • Sous "Actions", cliquez sur l'option "Liaisons"
  • Dans la fenêtre Site Bindings, cliquez sur 'Ajouter'
To set the bindings through which HTTPS will operate, you must include a port and a certificate in the site bindings.

Cela ouvrira la fenêtre Ajouter une liaison de site.

Définissez ces paramètres :

  • Type : HTTPS
  • Port : 443
  • Certificat SSL : sélectionnez le certificat créé dans Configurer un certificat e
To set the bindings through which HTTPS will operate, you must include a port and a certificate in the site bindings.

Module HTTP

Pour configurer le module HTTP dans le gestionnaire des services Internet (IIS) :

  1. Dans le panneau 'Connexions', sélectionnez les propriétés de la machine (en haut de l'arborescence).
  2. Double-cliquez sur l'icône Modules dans le panneau du milieu.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
    Cela renvoie la liste 'Modules' et la vue 'Actions'.
  3. Dans la liste 'Actions', cliquez sur l'option 'Configurer les modules natifs…'.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
    Cela ouvre la vue "Configurer les modules natifs".
  4. Cliquez sur le bouton Enregistrer pour ouvrir la boîte de dialogue 'Enregistrer le module natif' .
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
    Type le nom et le chemin du fichier SSCSIISHttpLink.dll.
  5. Cliquez sur le bouton OK . La case à cocher 'SSCloudServices' sera maintenant cochée.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
  6. Cliquez sur le bouton OK pour fermer la boîte de dialogue 'Configurer les modules natifs' .
  7. Dans le panneau 'Connexions' (voir étape 1), cliquez sur votre site Web.
  8. Double-cliquez sur "Handler Mappings" dans le volet du milieu.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
    Cela ouvre la vue Mappages de gestionnaires :
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
  9. Dans la liste "Actions", cliquez sur l'option "Ajouter un mappage de module" pour ouvrir la boîte de dialogue "Ajouter un mappage de module".
  10. Comme illustré, définissez le 'Request path' et le 'Name'.
  11. Dans le champ 'Module', cliquez sur la flèche déroulante et sélectionnez le module ajouté à l'étape 4.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
  12. Cliquez sur le bouton Demander des restrictions. Dans la boîte de dialogue "Demander des restrictions", sélectionnez l'onglet "Accès". Sélectionnez le bouton radio « Exécuter » pour activer l'autorisation d'exécution.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
  13. Sélectionnez l'onglet 'Mappings' et décochez la case 'Invoke Handler only if request is mapped to'.
  14. Cliquez sur le bouton OK .
  15. Fermez la boîte de dialogue 'Add Module Mapping' en cliquant à nouveau sur le bouton OK .
Pour terminer la configuration de ce module HTTP, consultez la section Paramètres de configuration au début de cette rubrique. Vous devriez alors pouvoir vous connecter à un modèle en utilisant Enterprise Architect via votre serveur IIS en utilisant le module HTTP (par exemple via le port 80 ou 443).

Module ISAPI

Pour configurer un module ISAPI au lieu du module HTTP :

  1. Dans les "Connexions" panneau, sélectionnez les propriétés de la machine :
    Configuring an ISAPI module
  2. Double-cliquez sur les 'Handler Mappings' icône:
    Cloud IIS Mappings Icon
  3. Dans les 'Actions' liste, cliquez sur 'Ajouter un mappage de module' option.
  4. Dans la boîte de dialogue 'Add Module Mapping', définissez 'Request path' sur 'sparxCloudLink.sseap', 'Module' sur 'IsapiModule' et 'Executable' sur 'SSCSIISIsapiLink.dll', comme indiqué.
    Configuring an ISAPI module
  5. Cliquez sur le bouton Demander des restrictions. Dans la boîte de dialogue "Demander des restrictions", sélectionnez l'onglet "Accès". Sélectionnez le bouton radio « Exécuter » pour activer l'autorisation d'exécution.
    Setting up the HTTP module in the Internet Information Services (IIS) Manager
  6. Sélectionnez l'onglet 'Mappings' et décochez la case 'Invoke Handler only if request is mapped to', puis cliquez sur le bouton OK pour fermer la boîte de dialogue 'Request Restrictions' .
  7. Cliquez sur OK pour fermer la boîte de dialogue « Ajouter un mappage de module ». Vous devriez maintenant pouvoir vous connecter à un modèle en utilisant Enterprise Architect via votre serveur IIS en utilisant ISAPI.

Apprenez Plus