Cette page a été traduite par l'API Cloud Translation.

Intégrer Google Traduction à Google SecOps

Ce document explique comment configurer et intégrer Google Traduction à Google Security Operations (Google SecOps).

Version de l'intégration : 4.0

Avant de commencer

Pour utiliser l'intégration, vous devez créer et configurer une clé API.

Créer la clé API

Pour créer la clé API, procédez comme suit :

Dans la console Google Cloud , accédez à API et services> Identifiants.

Accéder à "Identifiants"
Cliquez sur add Créer des identifiants.
Sélectionnez Clé API pour générer une clé API. Une boîte de dialogue contenant une clé API générée s'affiche.
Pour copier la clé API, cliquez sur Copier.

Configurer les restrictions de clé API

Pour configurer la restriction d'API pour la clé API, procédez comme suit :

Cliquez sur Restreindre la clé.
Sous Restrictions relatives aux API, sélectionnez Restreindre la clé.
Sélectionnez l'API Cloud Translation dans la liste des API.
Configurez les restrictions applicables.
Cliquez sur Enregistrer pour enregistrer la configuration de la clé API.

Paramètres d'intégration

L'intégration Google Traduction nécessite les paramètres suivants :

Paramètre Description

Paramètre	Description
`API Root`	Obligatoire. Racine de l'API de l'instance Google Traduction. La valeur par défaut est `https://translation.googleapis.com`. Pour en savoir plus sur l'API Cloud Translation, consultez API Cloud Translation.
`API Key`	Obligatoire. Clé API du compte Google Traduction.
`Verify SSL`	Obligatoire. Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur Google Traduction. Cette option est sélectionnée par défaut.

API Root

Obligatoire.

Racine de l'API de l'instance Google Traduction.

La valeur par défaut est https://translation.googleapis.com.

Pour en savoir plus sur l'API Cloud Translation, consultez API Cloud Translation.

API Key

Obligatoire.

Clé API du compte Google Traduction.

Verify SSL

Obligatoire.

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur Google Traduction.

Cette option est sélectionnée par défaut.

Pour obtenir des instructions sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement, si nécessaire. Une fois que vous avez configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour savoir comment configurer et prendre en charge plusieurs instances, consultez Prise en charge de plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis Votre bureau et Effectuer une action manuelle.

Lister les langues

Utilisez l'action List Languages (Lister les langues) pour lister les langues disponibles dans Google Traduction.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Lister les langues nécessite les paramètres suivants :

Paramètre	Description
`Filter Key`	Facultatif. Clé permettant de filtrer les langues. Voici les valeurs possibles : `Select One` `Name` La valeur par défaut est `Select One`.
`Filter Logic`	Facultatif. Logique de filtre à appliquer. La logique de filtrage utilise la valeur que vous définissez dans le paramètre `Filter Key`. Les valeurs possibles sont les suivantes : `Not Specified` `Equal` `Contains` La valeur par défaut est `Not Specified`.
`Filter Value`	Facultatif. Valeur à utiliser dans le filtre. La logique de filtrage utilise la valeur que vous définissez dans le paramètre `Filter Key`. Si `Equal` est sélectionné, l'action recherche la correspondance exacte parmi les résultats. Si `Contains` est sélectionné, l'action recherche les résultats contenant la sous-chaîne spécifiée. Si vous ne sélectionnez pas de valeur, l'action ignore le filtre. La logique de filtrage fonctionne en fonction de la valeur fournie dans le paramètre `Filter Key`.
`Max Records To Return`	Facultatif. Nombre maximal d'enregistrements à renvoyer. La valeur maximale est de `50`. Si vous ne définissez pas de valeur, l'action renvoie 50 enregistrements par défaut.

Sorties d'action

L'action Lister les langues fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe au mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Table du mur des cas	Disponible
Table d'enrichissement	Non disponible
Résultat JSON	Disponible
Messages de sortie	Disponible
Résultat du script	Disponible

Table du mur des cas

L'action Lister les langues peut générer le tableau suivant :

Nom de la table : Available Languages

Colonne du tableau : Clé de langue

Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les langues :

{
    "data": {
        "languages": [
            {
                "language": "af"
            },
            {
                "language": "am"
            },
            {
                "language": "ar"
            }

        ]
    }
}

Messages de sortie

L'action Lister les langues peut renvoyer les messages de sortie suivants :

Message affiché Description du message

Message affiché	Description du message
`Successfully found language for the provided criteria in Google Translate.` `No languages were found for the provided criteria in Google Translate.` `The filter was not applied, because parameter "Filter Value" has an empty value.`	L'action a réussi.
`Error executing action "List Languages". Reason: ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Successfully found language for the provided criteria in Google Translate.

No languages were found for the provided criteria in Google Translate.

The filter was not applied, because parameter "Filter Value" has an empty value.

L'action a réussi.

Error executing action "List Languages". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Lister les langues :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Ping

Utilisez l'action Ping pour tester la connectivité à Google Traduction.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

Aucun

Sorties d'action

L'action Ping fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe au mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Table du mur des cas	Non disponible
Table d'enrichissement	Non disponible
Résultat JSON	Non disponible
Messages de sortie	Disponible
Résultat du script	Disponible

Messages de sortie

L'action Ping peut renvoyer les messages de résultat suivants :

Message affiché Description du message

Message affiché	Description du message
`Successfully connected to the Google Translate server with the provided connection parameters!`	L'action a réussi.
`Failed to connect to the Google Translate server! Error is ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Successfully connected to the Google Translate server with the provided connection parameters!

L'action a réussi.

Failed to connect to the Google Translate server! Error is ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant répertorie la valeur du résultat du script lorsque vous utilisez l'action Ping :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Traduire du texte

Utilisez l'action Traduire du texte pour traduire du texte avec Google Traduction.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Traduire du texte nécessite les paramètres suivants :

Paramètre Description

Paramètre	Description
`Source Language`	Facultatif. Langue source du texte. Si vous ne configurez pas ce paramètre, l'action détecte automatiquement la langue.
`Target Language`	Obligatoire. Une langue cible. La valeur par défaut est `en`.
`Text`	Obligatoire. Texte à traduire.

Source Language

Facultatif.

Langue source du texte.

Si vous ne configurez pas ce paramètre, l'action détecte automatiquement la langue.

Target Language

Obligatoire.

Une langue cible.

La valeur par défaut est en.

Text

Obligatoire.

Texte à traduire.

Sorties d'action

L'action Traduire du texte fournit les sorties suivantes :

Type de sortie de l'action	Disponibilité
Pièce jointe au mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Table du mur des cas	Non disponible
Table d'enrichissement	Non disponible
Résultat JSON	Disponible
Messages de sortie	Disponible
Résultat du script	Disponible

Résultat JSON

L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Traduire du texte :

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}

Messages de sortie

L'action Traduire du texte peut renvoyer les messages de sortie suivants :

Message affiché Description du message

Message affiché	Description du message
`Successfully translated the provided text in Google Translate.`	L'action a réussi.
`Error executing action "Translate Text". Reason: ERROR_REASON`	Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Successfully translated the provided text in Google Translate.

L'action a réussi.

Error executing action "Translate Text". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Traduire du texte :

Nom du résultat du script	Valeur
`is_success`	`True` ou `False`

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.