L'API Alert Center vous permet de gérer les alertes qui affectent votre domaine. Une alerte est un avertissement concernant un potentiel problème de sécurité détecté par Google. Les alertes incluent les informations suivantes:
- Source à l'origine de l'alerte.
- Nom de l'alerte.
- Heure à laquelle cette alerte s'est produite.
- Données spécifiques associées à cette alerte.
Les administrateurs de domaine peuvent afficher et gérer les alertes manuellement à partir du Console d'administration Google La L'API Alert Center permet aux applications que vous créez de récupérer les données et les commentaires des alertes. La L'API peut également créer des commentaires pour les alertes existantes.
Par exemple, une application de surveillance peut utiliser l'API Alert Center pour récupérer les alertes les plus récentes pour un domaine, les hiérarchiser, puis en informer les membres de votre organisation. Une fois que votre équipe a répondu à l'alerte, l'application peut alors joindre des commentaires à l'alerte en fonction de leurs résultats.
Utiliser l'API Alert Center
Avant d'utiliser l'API Alert Center, vous devez configurer un nouveau projet Cloud Platform et activer l'API Alert Center. Votre projet doit utiliser un compte de service lorsque vous accédez à l'API.
Une fois que votre application dispose d'un projet Cloud qui remplit les conditions préalables et est correctement autorisée, elle peut Requêtes REST de l'API du centre d'alerte. Il est plus facile d'effectuer des requêtes API avec la classe bibliothèques clientes disponibles.
L'exemple suivant montre comment répertorier les alertes disponibles à l'aide de l'API:
Java
// First, authorize the API and create a client to make requests with.
URL serviceAccountUrl = AuthUtils.class.getResource("/client_secret.json");
GoogleCredentials credentials = ServiceAccountCredentials
.fromStream(serviceAccountUrl.openStream())
.createDelegated("admin@xxxx.com")
.createScoped(Collections.singleton("https://www.googleapis.com/auth/apps.alerts"));
ApacheHttpTransport transport = new ApacheHttpTransport();
HttpCredentialsAdapter adapter = new HttpCredentialsAdapter(credentials);
AlertCenter alertCenter = new AlertCenter.Builder(transport, new JacksonFactory(), adapter)
.setApplicationName("Alert Center client")
.build();
// List alerts in pages, printing each alert discovered.
String pageToken = null;
do {
ListAlertsResponse listResponse = service.alerts().list().setPageToken(pageToken)
.setPageSize(20).execute();
if (listResponse.getAlerts() != null) {
for (Alert alert : listResponse.getAlerts()) {
System.out.println(alert);
}
}
pageToken = listResponse.getNextPageToken();
} while (pageToken != null);