Intégrer Google Traduction à Google SecOps

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

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 :

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

   Accéder à "Identifiants"

2. Cliquez sur add Créer des identifiants.

3. Sélectionnez Clé API pour générer une nouvelle clé API. Une boîte de dialogue s'affiche avec une clé API générée.

4. 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 :

1. Cliquez sur Restreindre la clé.

2. Sous API restrictions (Restrictions liées à l'API), sélectionnez Restrict key (Restreindre la clé).

3. Sélectionnez API Cloud Translation dans la liste des API.

4. Configurez les restrictions applicables.

5. 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
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 la page 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 savoir comment configurer une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement si nécessaire. Après avoir configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour en savoir plus sur la configuration et la prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis votre bureau et Exécuter une action manuelle dans votre demande.

Répertorier les langues

Utilisez l'action Lister les langues pour lister les langues disponibles dans Google Traduction.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

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

Paramètre	Description
Filter Key	Facultatif. Clé permettant de filtrer les langues. Les valeurs possibles sont les suivantes : 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 avez définie 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 avez définie dans le paramètre Filter Key. Si l'option Equal est sélectionnée, 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 50. Si vous ne définissez pas de valeur, l'action renvoie 50 enregistrements par défaut.

Sorties de l'action

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

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

Tableau du mur des cas

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

Nom du tableau : Langues disponibles

Colonne du tableau : Language Key

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 de sortie	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.

Résultat du script

Le tableau suivant indique 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'exécute pas sur les entités Google SecOps.

Entrées de l'action

Aucune.

Sorties de l'action

L'action Ping fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe du mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Tableau 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 sortie suivants :

Message de sortie	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.

Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Ping :

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

Traduction de texte

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

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

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

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.

Sorties de l'action

L'action Traduire du texte fournit les résultats suivants :

Type de sortie de l'action	Disponibilité
Pièce jointe du mur des cas	Non disponible
Lien vers le mur des cas	Non disponible
Tableau 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 obtenu 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 de sortie	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.

Résultat du script

Le tableau suivant liste 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.