Passer au contenu principal

Conception > Intégrations > Gérer les intégrations

Cette section vous permet de configurer les systèmes tiers avec lesquels vos applications interagissent.

Jason Liang avatar
Écrit par Jason Liang
Mis à jour cette semaine

La section "Gérer les intégrations" permet à votre application d’interagir avec de nombreux systèmes/plateformes tiers en les intégrant à votre backend d’application (brainCloud).

Depuis la page Gérer les intégrations, vous pouvez :

  • Faire l'intégration d'Amazon GameLift pour l'hébergement de serveurs de jeux dédiés.

  • Diffuser en continu des données d'événements vers votre sujet Apache Kafka.

  • Faire l'intégration de SAML pour l'authentification des utilisateurs finaux.

  • Diffuser en continu des données d'événements vers votre source de données Segment.

  • Envoyer des e-mails personnalisés au format texte enrichi avec votre compte SendGrid.

  • Envoyer des alertes d'erreur et des rapports quotidiens à vos canaux Slack.

  • Contrôler les grossièretés grâce à la configuration de WebPurify.

Pour commencer, rendez-vous sur la page Conception > Intégrations > Gérer les intégrations du portail brainCloud.

AWS GameLift

Amazon GameLift est un service géré permettant de déployer, d'exploiter et de faire évoluer des serveurs de jeux dédiés pour les jeux multijoueurs par session.

Pour autoriser brainCloud à accéder à votre ressource AWS GameLift, il est nécessaire de configurer les informations de votre compte AWS dans cette section.

Pour plus de détails sur la manière d'intégrer vos serveurs GameLift au système multijoueur brainCloud, veuillez consulter l'article ici .

Intégration Kafka

brainCloud propose également l'intégration de Kafka pour les événements DataStream, ainsi que l'intégration de Segment.

Avec Kafka et Segment, tous deux pris en charge nativement, il existe littéralement des centaines (voire des milliers) de systèmes que vous pouvez connecter à vos applications brainCloud pour une analyse de données plus approfondie, une exploration de données, etc.

  • Choisissez un fournisseur de serveur Kafka et créez une nouvelle instance Kafka sur ce serveur. Téléchargez les certificats et conservez-les sur votre système de fichiers local pour une utilisation ultérieure.

  • Créez un sujet depuis le tableau de bord de l'instance pour contenir l'événement de diffusion en continu provenant de brainCloud.

  • Renseignez-vous sur les détails de connexion du serveur de votre courtier, le protocole de sécurité utilisé pour cette connexion et le mécanisme SASL, le cas échéant.

  • Accédez à la page Design > Intégrations > Gérer les intégrations du portail brainCloud et faites défiler jusqu'à la section Kafka. Cochez la case [Activer] de l'intégration Apache Kafka] .

  • Remplissez les champs requis ci-dessus avec les informations que vous obtenez de votre instance de serveur Kafka, puis cliquez sur le bouton [Sauvegarder les modifications] pour enregistrer ces configurations.

Intégration SAML

brainCloud a été amélioré pour prendre en charge SAML pour l'authentification des usagers finaux. Ceci concerne principalement les clients non liés aux jeux* qui souhaitent intégrer leur application brainCloud à un annuaire d'entreprise.

Notre authentification SAML s'appuie sur la fonctionnalité d'authentification externe, en fournissant plusieurs points de terminaison clés qui peuvent être utilisés pour initier des appels et recevoir des rappels du fournisseur d'identité SAML.

Pour plus d'informations, consultez la section Configuration de l'authentification unique SAML .

Intégration de segments

Segment est une plateforme de données clients. Votre application peut envoyer à votre compte Segment des informations sur vos usagers et leur activité, et vous pouvez ensuite exploiter ces données avec des centaines d'outils d'analyse, de marketing et d'entreposage de données.

Une fois Segment configuré, vous pouvez implémenter une intégration côté serveur avec des outils d'analyse tiers (comme MixPanel) via notre intégration Segment.

  • Accédez à la page d'accueil de votre compte Segment et cliquez sur Add Source pour créer une source qui se connectera à votre application brainCloud.

  • Cliquez sur cette source, accédez à l'onglet Settings et à la section API Keys dans le panneau de gauche, notez l'ID de la source et écrivez la clé.

  • Retournez à la page Conception > Intégrations > Gérer les intégrations du portail brainCloud. Cochez la case [Activer] de l'intégration Segment et remplissez les champs obligatoires : l'ID du projet Segment (SourceID) et la clé d'écriture. Cliquez sur le bouton [Sauvegarder les modifications] pour enregistrer la configuration dans brainCloud.

  • Déconnectez-vous de votre compte du portail brainCloud et reconnectez-vous, puis accédez à la page Conception > Cloud Code > Explorateur d'API.

  • Après avoir authentifié un utilisateur, recherchez le service DataStream et l'opération CustomPageEvent, puis exécutez-la. Exécutez également les trois autres types d'événements disponibles dans cette sélection d'opérations : CustomScreenEvent, CustomTrackEvent et SubmitCrashReport.

  • Ouvrez votre page d'accueil Segment et consultez les événements de suivi de votre source Segment associée dans l'onglet Debugger.

Remarque : De nombreux autres événements de votre application seront également envoyés au hub de données Segment, tels que PostedTournamentScore, JoinedTournament, JoinedDivision, Identity Registered, etc. Ces événements seront classés comme suit : Identification : l’usager ; Page et écran : la page Web ou l’écran de l’application ; Suivi : l’action spécifique.

  • Dans le panneau de gauche, accédez à l'écran Connections, cliquez sur le bouton [Add Destination] , choisissez votre plateforme d'analytics et ajoutez-la à la source associée à votre application brainCloud. Vous pouvez sélectionner plusieurs plateformes.

  • Intégrez la plateforme cible à Segment. La procédure d'intégration varie selon les plateformes ; consultez leur documentation respective. Par exemple, pour intégrer Amplitude, vous devez créer un projet et saisir votre clé API Amplitude dans Segment.

  • Enregistrez votre API Key de projet Amplitude dans Segment depuis la page de configuration de destination.

  • Testez la transmission des données en sélectionnant un événement dans la liste des événements en direct et en choisissant la destination de test pour l'envoyer.

  • Vous devriez obtenir la réponse de destination à partir de l'écran Event Lifecycle.

  • Ouvrez le tableau de bord de votre plateforme de destination et vérifiez l'événement de test envoyé. Pour Amplitude, trouvez votre projet et consultez-le dans l'onglet "Events". Vous pouvez ensuite créer votre propre tableau de bord d'analyse de données personnalisé sur Amplitude.

Intégration SendGrid

brainCloud intègre SendGrid pour la gestion des courriels transactionnels. En intégrant brainCloud à leur compte SendGrid, les développeurs d'applications peuvent :

  • Utilisez SendGrid pour tous les courriels liés à l'authentification (validation, réinitialisation de mot de passe, etc.).

  • Personnalisez les courriels générés par brainCloud à l'aide des modèles de SendGrid

  • Envoyez des courriels aux utilisateurs via la nouvelle API brainCloud Mail

  • Consultez cet article de la base de connaissances pour obtenir des instructions sur la configuration de SendGrid pour l'intégration.

Intégration Slack

Grâce à l'intégration Slack, vous pouvez configurer un ou plusieurs canaux personnalisés pour recevoir des alertes provenant de catégories sélectionnées, notamment :

  • Chat - Violations du filtre de langage grossier

  • Déploiements - Déploiements d'applications

  • Hébergement - Mise en service/arrêt des serveurs de salle

  • Intégration - Avertissements d'expiration des notifications push

  • Tâches - Travaux de vérification des antécédents commencés/terminés

  • Achats - Notifications d'achat client

  • Consultez cet article de la base de connaissances pour obtenir des informations détaillées sur la configuration des webhooks Slack pour l'intégration.

Remarque : vous pouvez ajouter une seule URL de webhook Slack au canal par défaut, qui recevra toutes les alertes par catégorie, ou vous pouvez ajouter séparément les différentes URL de webhook Slack à des canaux de catégorie individuels, qui ne recevront que les alertes de la catégorie spécifiée.

Intégration WebPurify

En configurant les intégrations WebPurify avec votre application brainCloud, vous pouvez l'utiliser pour remplacer tout langage grossier susceptible d'apparaître dans le chat/message de votre application ou dans d'autres champs spécifiés.

  • Rendez-vous sur le site Web de WebPurify et créez un compte, accédez au tableau de bord et cliquez sur "View your account", vous trouverez une clé API dans les statistiques de votre compte.

  • Faites défiler vers le bas jusqu'à la section "Customize Filter" pour ajouter les mots à la liste de blocage ou à la liste d'autorisation. Par exemple, si vous ajoutez "amazon" à la liste de blocage, le mot "amazon" apparaîtra dans les résultats de la vérification des grossièretés.

  • Retournez à la page Conception > Intégrations > Gérer les intégrations du portail brainCloud. Cochez la case [Activer] de l'intégration WebPurify. Re-copiez la clé API dans le champ Clé API de la section de configuration WebPurify du portail brainCloud, sélectionnez les langues de filtrage et cochez le filtre par nom d'usager si vous le souhaitez.

  • Accédez à la page Conception > Code cloud > Explorateur d'API .

  • Après avoir authentifié un utilisateur, recherchez le Profanity Service et l'opération ProfanityIdentifyBadWords, puis exécutez-la comme indiqué ci-dessous. Vous pouvez également tester les deux autres API disponibles dans cette sélection d'opérations : ProfanityCheck et ProfanityReplaceText.

(Remarque : puisque nous avons précédemment défini "amazon" comme mot interdit dans la configuration du site web de WebPurify, la réponse le renverra sous la forme d’un foundCount.)

  • Vérifiez l'évolution des statistiques de détection des grossièretés dans votre compte WebPurify après quelques appels à l'API de détection des grossièretés de brainCloud.

Note:

  • ProfanityCheck() renvoie le nombre de foundCount ;

  • ProfanityReplaceText() remplacera effectivement les gros mots par un caractère de substitution que vous fournirez ;

  • La fonction ProfanityIdentifyBadWords() renvoie une liste des gros mots trouvés (utile principalement pour le débogage).

Avez-vous trouvé la réponse à votre question ?