Shodan
Ce document explique comment intégrer Shodan à Google SecOps.
Configurer l'intégration Shodan pour qu'elle fonctionne avec Google Security Operations
Pour obtenir la clé API, veuillez procéder comme suit :
Connectez-vous à votre compte Shodan.
Vous trouverez votre clé API dans la section Account Overview (Présentation du compte) de l'interface Shodan.
Configurer l'intégration de Shodan dans Google SecOps
Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.
Actions
Résolution DNS
Description
Trouvez l'adresse IP pour la liste de noms d'hôtes fournie.
Paramètres
N/A
Exécuter sur
Cette action s'exécute sur l'entité "Nom d'hôte".
Résultats de l'action
Enrichissement d'entités
| Nom du champ d'enrichissement | Logique : quand l'appliquer ? |
|---|---|
| google.com | Renvoie la valeur si elle existe dans le résultat JSON |
| bing.com | Renvoie la valeur si elle existe dans le résultat JSON |
Insights
N/A
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"google.com": "1.1.1.1",
"bing.com": "1.1.1.1"
}
DNS inversé
Description
Recherchez les noms d'hôte définis pour la liste d'adresses IP donnée.
Paramètres
N/A
Exécuter sur
Cette action s'exécute sur l'entité "Adresse IP".
Résultats de l'action
Enrichissement d'entités
| Nom du champ d'enrichissement | Logique : quand l'appliquer ? |
|---|---|
| 146.125.10.5 | Renvoie la valeur si elle existe dans le résultat JSON |
| 8.8.8.8 | Renvoie la valeur si elle existe dans le résultat JSON |
Insights
N/A
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"146.125.10.5": null,
"8.8.8.8": [
"google-public-dns-a.google.com"
]
}
Obtenir des informations sur l'API
Description
Renvoie des informations sur le forfait API auquel appartient la clé API spécifiée.
Paramètres
N/A
Exécuter sur
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Enrichissement d'entités
N/A
Insights
N/A
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"https": false,
"unlocked": false,
"unlocked_left": 0,
"telnet": false,
"scan_credits": 0,
"plan": "oss",
"query_credits": 0
}
Obtenir des informations sur l'adresse IP
Description
Obtenez toutes les informations disponibles sur une adresse IP.
Paramètres
| Paramètre | Type | Valeur par défaut | Description |
|---|---|---|---|
| Afficher les bannières historiques | Booléen | faux | True si toutes les bannières historiques doivent être renvoyées. |
| Définir la minification | Booléen | faux | La valeur "True" permet de renvoyer uniquement la liste des ports et les informations générales sur l'hôte, sans bannières. |
Exécuter sur
Cette action s'exécute sur l'entité "Adresse IP".
Résultats de l'action
Enrichissement d'entités
| Nom du champ d'enrichissement | Logique : quand l'appliquer ? |
|---|---|
| données | Renvoie la valeur si elle existe dans le résultat JSON |
| _shodan | Renvoie la valeur si elle existe dans le résultat JSON |
| id | Renvoie la valeur si elle existe dans le résultat JSON |
| robot d'exploration | Renvoie la valeur si elle existe dans le résultat JSON |
| options | Renvoie la valeur si elle existe dans le résultat JSON |
| module | Renvoie la valeur si elle existe dans le résultat JSON |
| ptr | Renvoie la valeur si elle existe dans le résultat JSON |
| hash | Renvoie la valeur si elle existe dans le résultat JSON |
| opts | Renvoie la valeur si elle existe dans le résultat JSON |
| brut | Renvoie la valeur si elle existe dans le résultat JSON |
| isp | Renvoie la valeur si elle existe dans le résultat JSON |
| port | Renvoie la valeur si elle existe dans le résultat JSON |
| noms d'hôte | Renvoie la valeur si elle existe dans le résultat JSON |
| emplacement | Renvoie la valeur si elle existe dans le résultat JSON |
| city | Renvoie la valeur si elle existe dans le résultat JSON |
| country_name | Renvoie la valeur si elle existe dans le résultat JSON |
| region_code | Renvoie la valeur si elle existe dans le résultat JSON |
| area_code | Renvoie la valeur si elle existe dans le résultat JSON |
| dma_code | Renvoie la valeur si elle existe dans le résultat JSON |
| country_code3 | Renvoie la valeur si elle existe dans le résultat JSON |
| postal_code | Renvoie la valeur si elle existe dans le résultat JSON |
| longitude | Renvoie la valeur si elle existe dans le résultat JSON |
| country_code | Renvoie la valeur si elle existe dans le résultat JSON |
| latitude | Renvoie la valeur si elle existe dans le résultat JSON |
| resolver_hostname | Renvoie la valeur si elle existe dans le résultat JSON |
| RECURSIVE | Renvoie la valeur si elle existe dans le résultat JSON |
| resolver_id | Renvoie la valeur si elle existe dans le résultat JSON |
| logiciel | Renvoie la valeur si elle existe dans le résultat JSON |
| timestamp | Renvoie la valeur si elle existe dans le résultat JSON |
| domaines | Renvoie la valeur si elle existe dans le résultat JSON |
| org | Renvoie la valeur si elle existe dans le résultat JSON |
| os | Renvoie la valeur si elle existe dans le résultat JSON |
| asn | Renvoie la valeur si elle existe dans le résultat JSON |
| transport | Renvoie la valeur si elle existe dans le résultat JSON |
| ip_str | Renvoie la valeur si elle existe dans le résultat JSON |
Insights
N/A
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
[
{
"EntityResult": {
"data": [
{
"_shodan": {
"id": "d670bfbb-4821-4320-969d-0590789ab502",
"crawler": "545144fc95e7a7ef13ece5dbceb98ee386b37950",
"options": {},
"module": "dns-udp",
"ptr": true
},
"hash": -553166942,
"opts": {
"raw": "34ef818200010000000000000756455253494f4e0442494e440000100003"
},
"ip": 134744072,
"isp": "Google",
"data": "nRecursion: enabled",
"port": 53,
"hostnames": ["google-public-dns-a.google.com"],
"location": {
"city": null,
"region_code": null,
"area_code": null,
"dma_code": null,
"country_code3": "USA",
"country_name": "United States",
"postal_code": null,
"longitude": -97.822,
"country_code": "US",
"latitude": 37.751000000000005
},
"dns": {
"resolver_hostname": null,
"recursive": true,
"resolver_id": null,
"software": null
},
"timestamp": "2019-01-29T12:36:09.300695",
"domains": ["google.com"],
"org": "Google",
"os": null,
"asn": "AS15169",
"transport": "udp",
"ip_str": "1.1.1.1"
}
],
"city": null,
"region_code": null,
"tags": [],
"ip": 134744072,
"isp": "Google",
"area_code": null,
"dma_code": null,
"last_update": "2019-01-29T12:36:09.300695",
"country_code3": "USA",
"country_name": "United States",
"hostnames": ["google-public-dns-a.google.com"],
"postal_code": null,
"longitude": -97.822,
"country_code": "US",
"ip_str": "1.1.1.1",
"latitude": 37.751000000000005,
"org": "Google",
"os": null,
"asn": "AS15169",
"ports": [53]
},
"Entity": "1.1.1.1"
}
]
Ping
Description
Vérifiez que l'utilisateur est connecté à Shodan depuis son appareil.
Paramètres
N/A
Exécuter sur
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Enrichissement d'entités
N/A
Insights
N/A
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_connected | Vrai/Faux | is_connected:False |
Résultat JSON
N/A
Analyser un réseau
Description
Analysez un réseau à l'aide de Shodan. Shodan explore l'ensemble d'Internet au moins une fois par mois. Toutefois, si vous souhaitez demander à Shodan d'analyser un réseau immédiatement, vous pouvez le faire à l'aide des fonctionnalités d'analyse à la demande de l'API.
Paramètres
N/A
Exécuter sur
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Enrichissement d'entités
N/A
Insights
N/A
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
N/A
Activer un utilisateur
Description
Mettre à jour l'attribut utilisateur : activer l'utilisateur.
Paramètres
| Paramètre | Type | Valeur par défaut | Description |
|---|---|---|---|
| Nom de l’utilisateur | Int | N/A | Nom d'utilisateur complet tel qu'il existe dans CyberArk Vault. |
Exécuter sur
Cette action s'exécute sur l'entité "Adresse IP".
Résultats de l'action
Enrichissement d'entités
N/A
Insights
N/A
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| success_scan | Vrai/Faux | success_scan:False |
Résultat JSON
N/A
Rechercher
Description
Recherchez dans la base de données Shodan.
Paramètres
| Paramètre | Type | Valeur par défaut | Description |
|---|---|---|---|
| Requête de recherche | 0 | N/A | Requête de recherche ; syntaxe identique à celle du site Web. Par exemple, recherchez les serveurs Web Apache situés en Allemagne(apache country:'DE', city:'Berlin'). |
| Attributs | 0 | N/A | Liste de propriétés séparées par une virgule pour lesquelles obtenir des informations récapitulatives. Les noms de propriétés peuvent également être au format "property:count". (par exemple, pays : 100, ville : 5). Pour en savoir plus, consultez https://developer.shodan.io/api. |
| Définir la minification | 1 | faux | Indique si la bannière doit être réduite et si seules les données importantes doivent être renvoyées. |
Exécuter sur
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Enrichissement d'entités
N/A
Insights
N/A
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"matches": [
{
"timestamp": "2014-01-15T05: 49: 56.283713",
"isp": "Vivacom",
"data": "@PJL INFO STATUS CODE=35078 DISPLAY=Power Saver ONLINE=TRUE",
"port": 9100,
"hostnames": [],
"location": {
"city": null,
"region_code": null,
"area_code": null,
"longitude": 25,
"country_code3": "BGR",
"country_name": "Bulgaria",
"postal_code": null,
"dma_code": null,
"country_code": "BG",
"latitude": 43
},
"ip": 3579573318,
"domains": [],
"org": "Vivacom",
"os": null,
"asn": "AS8866",
"ip_str": "1.1.1.1"
}
],
"facets": {
"org": [
{
"count": 107,
"value": "UniversityofMinnesota"
}
]
},
"total": 12039
}
Rechercher des failles
Description
Recherchez des failles dans différentes sources de données et utilisez des facettes pour obtenir des informations récapitulatives.
Paramètres
| Paramètre | Type | Valeur par défaut | Description |
|---|---|---|---|
| Requête de recherche | Chaîne | N/A | Requête de recherche utilisée pour rechercher dans la base de données des failles connues. |
| Attributs | Chaîne | N/A | Liste de propriétés séparées par une virgule pour lesquelles obtenir des informations récapitulatives. (par exemple, port, source, auteur). Pour en savoir plus, consultez https://developer.shodan.io/api. |
| Page | Chaîne | N/A | Numéro de page pour parcourir les résultats par groupes de 100. |
Exécuter sur
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Enrichissement d'entités
N/A
Insights
N/A
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"matches": [
{
"cve": "CVE-2011-2064",
"description": "Cisco IOS 12.4MDA before 12.4(24)MDA5 on the Cisco Content Services Gateway - Second Generation (CSG2) allows remote attackers to cause a denial of service (device reload) via crafted ICMP packets, aka Bug ID CSCtl79577.",
"osvdb": [73657],
"bid": [48581],
"source": "CVE",
"_id": "2011-2064",
"msb": []}],
"facets": {
"type": [
{
"count": 1,
"value": "remote"
}
]
},
"total": 4
}
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.