Microsoft Teams
Versione integrazione: 23.0
Questo documento fornisce indicazioni su come integrare Microsoft Teams con Google Security Operations (Google SecOps).
Configurare l'integrazione di Microsoft Teams per funzionare con Google Security Operations
Assicurati che l'account utilizzato per la configurazione dell'integrazione abbia la licenza Microsoft Teams abilitata. Per farlo, vai al Centro amministrazione Microsoft e controlla quale licenza è applicata all'utente necessario.
Dopo aver confermato che l'utente necessario dispone di una licenza, puoi iniziare a creare l'app per Microsoft Teams. Per prima cosa, vai ad Azure Active Directory > Registrazioni app.
Fai clic su Nuova registrazione e fornisci:
- un nome per l'app Teams
- un URI di reindirizzamento: "https://localhost"
Assicurati di salvare da qualche parte l'URI di reindirizzamento, poiché ti servirà più avanti nella procedura.
Vai alla pagina Panoramica e copia:
- ID applicazione (client): corrisponde al parametro "ID client" nella configurazione dell'integrazione
- ID directory (tenant): corrisponde al parametro "Tenant" nella configurazione dell'integrazione
Aggiungi le autorizzazioni necessarie. Tutte le autorizzazioni applicate sono "delegate" e dovrebbero avere questo aspetto:
Assicurati di concedere il consenso dell'amministratore per le autorizzazioni.
Vai alla scheda Certificates & secrets (Certificati e secret) e aggiungi un nuovo client secret. Quando viene generato il client secret, devi copiare i dati dalla colonna Valore. Questo valore è necessario per il parametro "Client Secret" della configurazione dell'integrazione.
Vai alla pagina di configurazione di Google SecOps SOAR e inserisci i seguenti parametri:
- ID client
- Client secret
- URI di reindirizzamento
- Tenant
Inserisci una stringa segnaposto per il parametro "Token di aggiornamento" e salva la configurazione.
Vai alla scheda Richieste e apri una richiesta. Se non hai una cover, puoi simularne una.
Seleziona un avviso nella richiesta e fai clic su Azione manuale.
Vai all'integrazione Microsoft Teams ed esegui l'azione "Ottieni autorizzazione". Questa azione genera un link utilizzato per l'autenticazione all'app.
Per visualizzare i risultati, vai alla scheda Bacheca richieste e fai clic su Visualizza risultati.
Dovresti vedere un output simile:
Fai clic sul link fornito dall'azione. Assicurati di aver eseguito l'accesso con un utente utilizzato per questa integrazione. Dopo aver aperto il link in un browser, noterai che ti ha reindirizzato a una pagina diversa. Questa pagina dovrebbe avere questo aspetto:
https://localhost/?code=0.ATwAylKP1BpbCEeO0…&session_state=a149d18b-4131-4649-8956-2f0d09a98743# Copy everything till "&session_state"
, ad esempio:https://localhost/?code=0.ATwAylKP1BpbCEeO0…
Esegui l'azione "Genera token".
Vai alla scheda Bacheca richieste per vedere i risultati. Nel messaggio di output troverai un token. Copia questo token e incollalo nel parametro "Refresh Token".
Se tutto è stato eseguito correttamente, vedrai un segno di spunta verde.
Configurare l'integrazione di Microsoft Teams in Google SecOps
Per istruzioni dettagliate su come configurare un'integrazione in Google SecOps, vedi Configurare le integrazioni.
Parametri di integrazione
Utilizza i seguenti parametri per configurare l'integrazione:
Nome parametro | Tipo | Predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome istanza | Stringa | N/D | No | Nome dell'istanza per cui intendi configurare l'integrazione. |
Descrizione | Stringa | N/D | No | Descrizione dell'istanza. |
ID client | Stringa | N/D | Sì | N/D |
ID secret | Password | N/D | Sì | N/D |
Tenant | Stringa | N/D | Sì | N/D |
Aggiorna token | Password | N/D | Sì | N/D |
URL di reindirizzamento | Stringa | http://localhost | No | Specifica l'URL di reindirizzamento che verrà utilizzato per autenticare l'integrazione. Il valore predefinito è http://localhost. Questo parametro influisce sulle azioni "Ottieni autorizzazione" e "Genera token". |
Azioni
Wait For Reply
Descrizione
L'azione attende la risposta prevista in un messaggio specifico.
Questa azione viene eseguita in modo asincrono. Modifica il valore di timeout dello script nell'IDE Google SecOps per l'azione in base alle esigenze.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome del team | Stringa | N/D | Sì | Specifica il nome del team. |
Nome del canale | Stringa | N/D | Sì | Specifica il nome del canale. |
ID messaggio | Stringa | N/D | Sì | Specifica l'ID del messaggio per cui è prevista una risposta. |
Risposta prevista | Stringa | N/D | Sì | Specifica il testo della risposta prevista. Se questo valore non viene fornito, l'azione interrompe l'esecuzione in caso di risposta. |
Metodo di attesa | DDL | Controlla la prima risposta Valori possibili:
|
No | Specifica il metodo di attesa per l'azione. Se è selezionata l'opzione Controlla prima risposta, l'azione restituisce la prima risposta o la confronta con un valore previsto. Se è selezionata l'opzione Attendi fino al timeout, l'azione attende il valore previsto fino al raggiungimento del timeout o restituisce tutti i messaggi inviati durante il periodo di timeout. |
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Genera token
Descrizione
Ottieni un token di accesso utilizzando l'URL di autorizzazione ricevuto nel passaggio precedente.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
URL di autorizzazione | Stringa | N/D | Sì | Utilizza l'URL di autorizzazione ricevuto nel passaggio precedente per richiedere un token di accesso. |
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_connected | Vero/Falso | is_connected:False |
Recupero autorizzazione
Descrizione
Esegui l'azione e vai all'URL ricevuto.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
URL di reindirizzamento | Stringa | N/D | Sì | Utilizza l'URL di autorizzazione ricevuto nel passaggio precedente per richiedere un token di accesso. |
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_connected | Vero/Falso | is_connected:false |
Ottieni l'ID team
Descrizione
Recupera le proprietà di un team specifico.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome del team | Stringa | N/D | Sì | Il nome del team. |
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Ottieni dettagli utente
Descrizione
Recupera le proprietà e le relazioni di un utente specifico.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome utente | Stringa | N/D | Sì | Nome utente del team Microsoft |
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Risultato JSON
{
"isResourceAccount": null,
"mailNickname": "username.co#EXT#",
"surname": null,
"deletedDateTime": null,
"assignedLicenses": [{
"skuId": "16ddbbfc-09ea-4de2-b1d7-312db6112d70",
"disabledPlans": []
}],
"userPrincipalName": "username.co#EXT#@tenant.onmicrosoft.com",
"faxNumber": null,
"consentProvidedForMinor": null,
"userType": "Member",
"officeLocation": null,
"usageLocation": "IL",
"city": null,
"employeeId": null,
"onPremisesImmutableId": null,
"preferredLanguage": null,
"streetAddress": null,
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users/$entity",
"id": "5e457a85-a705-4b65-8a9f-3a3d2ad7715c",
"state": null,
"businessPhones": [],
"postalCode": null,
"mail": "john_doe@example.com",
"onPremisesSamAccountName": null,
"onPremisesLastSyncDateTime": null,
"accountEnabled": true,
"mobilePhone": null,
"refreshTokensValidFromDateTime": "2018-11-12T13:28:53Z",
"companyName": null,
"deviceKeys": [],
"jobTitle": null,
"preferredDataLocation": null,
"showInAddressList": false,
"department": null,
"proxyAddresses": ["SMTP:mail"],
"externalUserStateChangeDateTime": "2018-11-12T13:29:41Z",
"onPremisesProvisioningErrors": [],
"legalAgeGroupClassification": null,
"onPremisesSyncEnabled": null,
"onPremisesExtensionAttributes": {
"extensionAttribute4": null,
"extensionAttribute5": null,
"extensionAttribute6": null,
"extensionAttribute7": null,
"extensionAttribute12": null,
"extensionAttribute1": null,
"extensionAttribute2": null,
"extensionAttribute3": null,
"extensionAttribute10": null,
"extensionAttribute11": null,
"extensionAttribute8": null,
"extensionAttribute9": null,
"extensionAttribute14": null,
"extensionAttribute15": null,
"extensionAttribute13": null
},
"assignedPlans": [{
"capabilityStatus": "Enabled",
"servicePlanId":
"617d9209-3b90-4879-96e6-838c42b2701d",
"service": "MicrosoftCommunicationsOnline",
"assignedDateTime": "2018-11-12T13:28:57Z"
}, {
"capabilityStatus": "Enabled",
"servicePlanId": "902b47e5-dcb2-4fdc-858b-c63a90a2bdb9",
"service": "SharePoint",
"assignedDateTime": "2018-11-12T13:28:57Z"
}, {
"capabilityStatus": "Enabled",
"servicePlanId": "4fa4026d-ce74-4962-a151-8e96d57ea8e4",
"service": "TeamspaceAPI",
"assignedDateTime": "2018-11-12T13:28:57Z"
}],
"passwordProfile": null,
"passwordPolicies": null,
"externalUserState": "Accepted",
"otherMails": ["mail"],
"displayName": "name",
"imAddresses": [],
"provisionedPlans": [{
"capabilityStatus": "Enabled",
"provisioningStatus": "Success",
"service": "SharePoint"
}],
"createdDateTime": "2018-11-12T13:28:53Z",
"country": null,
"onPremisesDistinguishedName": null,
"onPremisesSecurityIdentifier": null,
"onPremisesDomainName": null,
"onPremisesUserPrincipalName": null,
"givenName": null,
"ageGroup": null
}
Elenco canali
Descrizione
Visualizza i dettagli di tutti i canali esistenti in un team specifico.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome del team | Stringa | N/D | Sì | Il nome del team. |
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
all_channels_details | N/D | N/D |
Elenco squadre
Descrizione
Recupera i dettagli di tutte le squadre.
Parametri
Questa azione non ha parametri di input.
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
team | N/D | N/D |
Risultato JSON
[
{
"mailNickname": "Test",
"classification": null,
"deletedDateTime": null,
"renewedDateTime": "2018-11-12T15:03:50Z",
"onPremisesProvisioningErrors": [],
"membershipRuleProcessingState": null,
"preferredLanguage": null,
"expirationDateTime": null,
"id": "43b559d5-f63d-47dd-9e6c-b3470b6446ee",
"theme": null,
"preferredDataLocation": null,
"mail": "john_doe@example.com",
"membershipRule": null,
"onPremisesLastSyncDateTime": null,
"description": "Test",
"securityEnabled": false,
"proxyAddresses": ["SPO:SPO_eaf75319-582a-46cf-8812-9e787d757c4e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:Test@tenant.onmicrosoft.com"],
"visibility": "Public",
"resourceProvisioningOptions": ["Team"],
"displayName": "Test",
"groupTypes": ["Unified"],
"onPremisesSyncEnabled": null,
"createdDateTime": "2018-11-12T15:03:50Z",
"resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
"onPremisesSecurityIdentifier": null,
"mailEnabled": true
}, {
"mailNickname": "user",
"classification": null,
"deletedDateTime": null,
"renewedDateTime": "2018-11-28T13:46:50Z",
"onPremisesProvisioningErrors": [],
"membershipRuleProcessingState": null,
"preferredLanguage": null,
"expirationDateTime": null,
"id": "67149c85-7139-4062-bfae-059d18ee7e5d",
"theme": null,
"preferredDataLocation": null,
"mail": "john_doe@example.com",
"membershipRule": null,
"onPremisesLastSyncDateTime": null,
"description": "user",
"securityEnabled": false, "proxyAddresses": ["SPO:SPO_781470a6-2db5-454d-a8e3-71752b3b829e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:user@tenant.onmicrosoft.com"],
"visibility": "Public",
"resourceProvisioningOptions": ["Team"],
"displayName": "user",
"groupTypes": ["Unified"],
"onPremisesSyncEnabled": null,
"createdDateTime": "2018-11-28T13:46:50Z",
"resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
"onPremisesSecurityIdentifier": null,
"mailEnabled": true
}
Elenco utenti
Descrizione
Visualizza i dettagli di tutti gli utenti.
Parametri
Questa azione non ha parametri di input.
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
utenti | N/D | N/D |
Risultato JSON
[{
"mailNickname": "Test",
"classification": null,
"deletedDateTime": null,
"renewedDateTime": "2018-11-12T15:03:50Z",
"onPremisesProvisioningErrors": [],
"membershipRuleProcessingState": null,
"preferredLanguage": null,
"expirationDateTime": null,
"id": "43b559d5-f63d-47dd-9e6c-b3470b6446ee",
"theme": null,
"preferredDataLocation": null,
"mail": "john_doe@example.com",
"membershipRule": null,
"onPremisesLastSyncDateTime": null,
"description": "Test",
"securityEnabled": false,
"proxyAddresses": ["SPO:SPO_eaf75319-582a-46cf-8812-9e787d757c4e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:Test@tenant.onmicrosoft.com"],
"visibility": "Public",
"resourceProvisioningOptions": ["Team"],
"displayName": "Test",
"groupTypes": ["Unified"],
"onPremisesSyncEnabled": null,
"createdDateTime": "2018-11-12T15:03:50Z",
"resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
"onPremisesSecurityIdentifier": null,
"mailEnabled": true
}, {
"mailNickname": "user",
"classification": null,
"deletedDateTime": null,
"renewedDateTime": "2018-11-28T13:46:50Z",
"onPremisesProvisioningErrors": [],
"membershipRuleProcessingState": null,
"preferredLanguage": null,
"expirationDateTime": null,
"id": "67149c85-7139-4062-bfae-059d18ee7e5d",
"theme": null,
"preferredDataLocation": null,
"mail": "john_doe@example.com",
"membershipRule": null,
"onPremisesLastSyncDateTime": null,
"description": "user",
"securityEnabled": false,
"proxyAddresses": ["SPO:SPO_781470a6-2db5-454d-a8e3-71752b3b829e@SPO_a4a936ec-735f-488a-bfc0-7665f87aab47", "SMTP:user@tenant.onmicrosoft.com"],
"visibility": "Public",
"resourceProvisioningOptions": ["Team"],
"displayName": "user",
"groupTypes": ["Unified"],
"onPremisesSyncEnabled": null,
"createdDateTime": "2018-11-28T13:46:50Z",
"resourceBehaviorOptions": ["HideGroupInOutlook", "SubscribeMembersToCalendarEventsDisabled", "WelcomeEmailDisabled"],
"onPremisesSecurityIdentifier": null,
"mailEnabled": true
}]
Dindin
Descrizione
Testa la connettività.
Parametri
Questa azione non ha parametri di input.
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_connected | Vero/Falso | is_connected:False |
Invia messaggio
Descrizione
Invia un messaggio a un canale specifico.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome del team | Stringa | N/D | Sì | Nome del team. |
Nome del canale | Stringa | N/D | Sì | Nome del canale. |
Messaggio | Stringa | N/D | Sì | Messaggio. |
Run On
Questa azione viene eseguita su tutte le entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Risultato JSON
[{
"@odata.context":"https://graph.microsoft.com/beta/$metadata#teams('192c0699-fad2-4d02-88a2-84efd6369894')/channels('19%3Ae3acbb17a8754cae9df724f493b5342f%40thread.tacv2')/messages/$entity",
"id":"1601372154742",
"replyToId":null,
"etag":"1601372154742",
"messageType":"message",
"createdDateTime":"2020-09-29T09:35:54.742Z",
"lastModifiedDateTime":"2020-09-29T09:35:54.742Z",
"lastEditedDateTime":null,
"deletedDateTime":null,
"subject":null,
"summary":null,
"chatId":null,
"importance":"normal",
"locale":"en-us",
"webUrl":"https://teams.microsoft.com/l/message/19%3Ae3acbb17a8754cae9df724f493b5342f%40thread.tacv2/1601372154742?groupId=192c0699-fad2-4d02-88a2-84efd6369894&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a&createdTime=1601372154742&parentMessageId=1601372154742",
"policyViolation":null,
"from":{
"application":null,
"device":null,
"conversation":null,
"user":{
"id":"b786d3cf-e97d-4511-b61c-0559e9f4da75",
"displayName":"u05D2'u05D9u05D9u05DEu05E1 u05D1u05D5u05E0u05D3",
"userIdentityType":"aadUser"
}},
"body":{
"contentType":"text",
"content":"Hello there"
},
"channelIdentity":{
"teamId":"192c0699-fad2-4d02-88a2-84efd6369894",
"channelId":"19:e3acbb17a8754cae9df724f493b5342f@thread.tacv2"
},
"attachments":[],
"mentions":[],
"reactions":[]
}]
Invia messaggio all'utente
Descrizione
Invia un messaggio di chat all'utente in Microsoft Teams.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Identificatori utente | CSV | N/D | No | Specifica un elenco separato da virgole di identificatori utente a cui vuoi inviare un messaggio. Nota:l'azione combina le entità e i valori validi forniti in questo parametro e invia il messaggio a tutti. |
Testo | Stringa | N/D | Sì | Specifica il contenuto del messaggio. |
Wait For Reply | Casella di controllo | Selezionata | Sì | Se abilitata, l'azione attende che siano disponibili le risposte di tutte le entità. |
Tipo di contenuti | DDL | Selezionata | Sì | Specifica il tipo di contenuti per il messaggio. |
Selezione dell'utente | DDL | Testo Valori possibili:
|
Da Entità e identificatori utente Valori possibili:
|
Specifica il tipo di selezione da utilizzare per gli utenti. Se è selezionata l'opzione "Da entità e identificatori utente", l'azione esegue la ricerca sia nelle entità pertinenti sia nei valori forniti nei parametri "Identificatori utente". Se viene fornito "Dalle entità", l'azione funziona solo con le entità pertinenti e ignora i valori forniti nel parametro "Identificatori utente". Se è selezionata l'opzione"Da identificatori utente ", l'azione funziona solo con i valori dei parametri "Identificatori utente", che diventano obbligatori. |
Run On
Questa azione viene eseguita sulle seguenti entità:
- Nome utente
- Indirizzo email
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Risultato JSON
{
"id": "1632820681737",
"replyToId": null,
"etag": "1632820681737",
"messageType": "message",
"createdDateTime": "2021-09-28T09:18:01.737Z",
"lastModifiedDateTime": "2021-09-28T09:18:01.737Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
"importance": "normal",
"locale": "en-us",
"webUrl": null,
"channelIdentity": null,
"policyViolation": null,
"from": {
"application": null,
"device": null,
"user": {
"id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"displayName": "ג'יימס בונד",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "text",
"content": "qqq"
},
"attachments": [],
"mentions": [],
"reactions": []
}
Bacheca casi
Tipo di risultato | Valore/Descrizione | Tipo |
---|---|---|
Messaggio di output* | L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
Se non viene trovata una chat con un'entità (is_success = true): "L'azione non è riuscita a inviare un messaggio ai seguenti utenti in Microsoft Teams: {entity.identifier}." Se non vengono trovate tutte le chat con un'entità (is_success = false): "Non sono stati inviati messaggi agli utenti forniti in Microsoft Teams." Async Message: "In attesa di una risposta dai seguenti utenti: {entity.identifier}." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore critico: "Errore durante l'esecuzione dell'azione "Invia messaggio all'utente". Motivo: {0}''.format(error.Stacktrace) Se timeout: "Errore durante l'esecuzione dell'azione "Invia messaggio all'utente". Motivo: i messaggi sono stati inviati, ma l'azione è scaduta durante l'attesa di una risposta dai seguenti utenti: {entity.identifier}." Aumenta il timeout nell'IDE e riprova. Nota: se riprovi l'azione, verrà inviato un altro messaggio. |
Generale |
Creazione canale
Descrizione
Crea un canale in Microsoft Teams.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome del team | Stringa | N/D | Sì | Specifica il nome del team in cui devi creare il canale. |
Nome del canale | Stringa | N/D | Sì | Specifica un nome univoco per il canale. |
Tipo di canale | DDL | Standard Valori possibili:
|
Sì | Specifica il tipo di canale da creare. Il canale standard è accessibile a tutti i membri del team, mentre il canale privato richiede l'aggiunta degli utenti. |
Descrizione | Stringa | N/D | No | Specifica una descrizione per il canale. |
Run On
Questa azione non viene eseguita sulle entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Risultato JSON
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('c084d2c7-a7e6-47a5-921b-0c32c3ab41d1')/channels/$entity",
"id": "19:92ce922c1790450fae81f6713dbffbe3@thread.tacv2",
"createdDateTime": "2021-11-18T11:37:39.8186647Z",
"displayName": "Architecturea Discussion",
"description": null,
"isFavoriteByDefault": false,
"email": "",
"webUrl": "https://teams.microsoft.com/l/channel/19%3a92ce922c1790450fae81f6713dbffbe3%40thread.tacv2/Architecturea+Discussion?groupId=c084d2c7-a7e6-47a5-921b-0c32c3ab41d1&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a",
"membershipType": "standard"
}
Bacheca casi
Tipo di risultato | Valore/Descrizione | Tipo |
---|---|---|
Messaggio di output* | L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore critico: "Errore durante l'esecuzione dell'azione "Crea canale". Motivo: {0}''.format(error.Stacktrace) Se il team non viene trovato: "Errore durante l'esecuzione dell'azione "Crea canale". Motivo: il team con nome {team, name} non è stato trovato in Microsoft Teams. Se viene segnalato il codice di stato 400: "Errore durante l'esecuzione dell'azione "Crea canale". Motivo: {innerError/message}. |
Generale |
Elimina canale
Descrizione
Eliminare un canale in Microsoft Teams.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome del team | Stringa | N/D | Sì | Specifica il nome del team in cui devi eliminare il canale. |
Nome del canale | Stringa | N/D | Sì | Specifica un nome del canale da eliminare. |
Run On
Questa azione non viene eseguita sulle entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Bacheca casi
Tipo di risultato | Valore/Descrizione | Tipo |
---|---|---|
Messaggio di output* | L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
Se il canale non viene trovato (is_success = true): "Il canale "{channel name}" non esisteva già nel team "{team name}" in Microsoft Teams." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore critico: "Errore durante l'esecuzione dell'azione "Elimina canale". Motivo: {0}''.format(error.Stacktrace) Se il team non viene trovato: "Errore durante l'esecuzione dell'azione "Elimina canale". Motivo: il team con nome {team, name} non è stato trovato in Microsoft Teams. |
Generale |
Aggiungere utenti al canale
Descrizione
Aggiungi utenti al canale privato in Microsoft Teams.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome del team | Stringa | N/D | Sì | Specifica il nome del team in cui vuoi cercare il canale. |
Nome del canale | Stringa | N/D | Sì | Specifica il nome del canale a cui vuoi aggiungere utenti. |
Run On
Questa azione viene eseguita sulle seguenti entità:
- Nome utente
- Indirizzo email
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Bacheca casi
Tipo di risultato | Valore/Descrizione | Tipo |
---|---|---|
Messaggio di output* | L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
Se l'utente non viene trovato per un'entità (is_success = true): "L'azione non è riuscita a trovare i seguenti utenti in Microsoft Teams: {entity.identifier}" Se viene segnalato il codice di stato 400 per un'entità (is_success = true): "L'azione non è riuscita ad aggiungere i seguenti utenti al canale "{Channel Name}" del team "{team name}" in Microsoft Teams: {entity.identifier}. Assicurati che gli utenti facciano parte del team "{team name}". Se l'utente non viene trovato per tutti (is_success = false): "Nessuno degli utenti forniti è stato trovato in Microsoft Teams." Se viene segnalato il codice di stato 400 per tutti (is_success = false): "L'azione non è riuscita ad aggiungere gli utenti forniti al canale "{Channel Name}" del team "{team name}" in Microsoft Teams. Assicurati che gli utenti facciano parte del team "{team name}". L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore critico: "Error executing action "Add Users To Channel". Motivo: {0}''.format(error.Stacktrace) Se il team non viene trovato: "Error executing action "Add Users To Channel". Motivo: il team con nome {team, name} non è stato trovato in Microsoft Teams. Se il canale non viene trovato: "Errore durante l'esecuzione dell'azione "Aggiungi utenti al canale". Motivo: il canale con nome {channel name} non è stato trovato in Microsoft Teams. Se "membershipType" != "private" per il canale: "Errore durante l'esecuzione dell'azione "Aggiungi utenti al canale". Motivo: il canale con il nome {channel name} non è privato. |
Generale |
Rimuovere utenti dal canale
Descrizione
Rimuovi gli utenti dal canale privato in Microsoft Teams.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome del team | Stringa | N/D | Sì | Specifica il nome del team in cui vuoi cercare il canale. |
Nome del canale | Stringa | N/D | Sì | Specifica un nome del canale in cui vuoi rimuovere gli utenti. |
Run On
Questa azione viene eseguita sulle seguenti entità:
- Nome utente
- Indirizzo email (nome utente che corrisponde all'espressione regolare dell'email)
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Bacheca casi
Tipo di risultato | Valore/Descrizione | Tipo |
---|---|---|
Messaggio di output* | L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
Se l'utente non fa parte del canale (is_success = true): "I seguenti utenti non facevano già parte del canale "{Channel Name}" del team "{team name}" in Microsoft Teams: {entity.identifier}" Se tutti gli utenti non fanno parte del canale (is_success = true): "Nessuno degli utenti forniti faceva parte del canale "{Channel Name}" del team "{team name}" in Microsoft Teams." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore critico: "Errore durante l'esecuzione dell'azione "Rimuovi utenti dal canale". Motivo: {0}''.format(error.Stacktrace) Se il team non viene trovato: "Errore durante l'esecuzione dell'azione "Rimuovi utenti dal canale". Motivo: il team con nome {team, name} non è stato trovato in Microsoft Teams. Se il canale non viene trovato: "Errore durante l'esecuzione dell'azione "Rimuovi utenti dal canale". Motivo: il canale con nome {channel name} non è stato trovato in Microsoft Teams. Se "membershipType" != "private" per il canale: "Errore durante l'esecuzione dell'azione "Rimuovi utenti dal canale". Motivo: il canale con il nome {channel name} non è privato. |
Generale |
Crea Chat
Descrizione
Crea una chat utente in Microsoft Teams.
Parametri
Questa azione non ha parametri di input.
Run On
Questa azione viene eseguita sulle seguenti entità:
- Nome utente
- Indirizzo email (nome utente che corrisponde all'espressione regolare dell'email)
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Risultato JSON
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats/$entity",
"id": "19:b786d3cf-e97d-4511-b61c-0559e9f4da75_cb786032-1ba9-439a-b714-99286e185921@unq.gbl.spaces",
"topic": null,
"createdDateTime": "2021-10-13T11:24:15.696Z",
"lastUpdatedDateTime": "2021-10-13T11:24:15.696Z",
"chatType": "oneOnOne"
}
Bacheca casi
Tipo di risultato | Valore/Descrizione | Tipo |
---|---|---|
Messaggio di output* | L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se viene segnalato il codice di stato 201 (is_success = true): "Chat creata correttamente con i seguenti utenti in Microsoft Teams: {entities}" If the user is not found (is_success = true): "The following users were not found in Microsoft Teams: {entities}" Se non vengono trovati tutti gli utenti (is_success = false): "Nessuno degli utenti forniti è stato trovato in Microsoft Teams: {entities}" Se viene segnalato il codice di stato 400 per un'entità (is_success = true): "L'azione non è riuscita a creare una chat con i seguenti utenti in Microsoft Teams: {entities}" Se viene segnalato il codice di stato 400 per tutte le entità (is_success = false): "L'azione non è riuscita a creare una chat con gli utenti forniti in Microsoft Teams." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore critico: "Errore durante l'esecuzione dell'azione "Crea chat". Motivo: {0}''.format(error.Stacktrace) |
Generale |
List Chats
Descrizione
Elenca le chat disponibili in Microsoft Teams.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Tipo di chat | DDL | Tutti Valori possibili:
|
No | Specifica il tipo di chat da restituire. |
Chiave di filtro | DDL | Selezionane uno Valori possibili:
|
No | Specifica la chiave da utilizzare per filtrare le chat. |
Logica di filtro | DDL | Non specificato Valori possibili:
|
No | Specifica la logica di filtro da applicare. La logica di filtraggio funziona in base al valore fornito nel parametro "Chiave filtro". |
Valore filtro | Stringa | N/D | No | Specifica il valore da utilizzare nel filtro. Se è selezionato "Uguale a", l'azione tenterà di trovare la corrispondenza esatta tra i risultati. Se è selezionato "Contiene", l'azione tenterà di trovare risultati che contengono quella sottostringa. Se non viene fornito alcun valore in questo parametro, il filtro non verrà applicato. La logica di filtraggio funziona in base al valore fornito nel parametro "Chiave filtro". |
Numero massimo di record da restituire | Numero intero | 50 | No | Specifica il numero di record da restituire. Se non viene fornito nulla, l'azione restituirà 50 record. |
Run On
Questa azione non viene eseguita sulle entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Risultato JSON
{
"id": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
"topic": null,
"createdDateTime": "2021-04-12T08:36:52.572Z",
"lastUpdatedDateTime": "2021-09-28T09:31:58.045Z",
"chatType": "oneOnOne",
"members@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats('19%3A5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75%40unq.gbl.spaces')/members",
"members": [
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "MCMjZDQ4ZjUyY2EtNWIxYS00NzA4LThlZDAtZWJiOThhMjZhNDZhIyMxOTo1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTJfYjc4NmQzY2YtZTk3ZC00NTExLWI2MWMtMDU1OWU5ZjRkYTc1QHVucS5nYmwuc3BhY2VzIyM1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTI=",
"roles": [
"Owner"
],
"displayName": "yuriy",
"visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
"userId": "5af81bea-9c9f-4f9f-8745-9df1fdba8e12",
"email": null,
"tenantId": "d48f52ca-5b1a-4708-8ed0-ebb98a26a46a"
},
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "MCMjZDQ4ZjUyY2EtNWIxYS00NzA4LThlZDAtZWJiOThhMjZhNDZhIyMxOTo1YWY4MWJlYS05YzlmLTRmOWYtODc0NS05ZGYxZmRiYThlMTJfYjc4NmQzY2YtZTk3ZC00NTExLWI2MWMtMDU1OWU5ZjRkYTc1QHVucS5nYmwuc3BhY2VzIyNiNzg2ZDNjZi1lOTdkLTQ1MTEtYjYxYy0wNTU5ZTlmNGRhNzU=",
"roles": [
"Owner"
],
"displayName": "ג'יימס בונד",
"visibleHistoryStartDateTime": "0001-01-01T00:00:00Z",
"userId": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"email": "james.bond@siemplifycyarx.onmicrosoft.com",
"tenantId": "d48f52ca-5b1a-4708-8ed0-ebb98a26a46a"
}
]
}
Bacheca casi
Tipo di risultato | Valore/Descrizione | Tipo |
---|---|---|
Messaggio di output* | L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se i dati sono disponibili (is_success = true): "Successfully found chats for the provided criteria in Microsoft Teams". Se i dati non sono disponibili (is_success=false): "Non sono state trovate chat per i criteri forniti in Microsoft Teams." Se il campo del parametro "Valore filtro" è vuoto (is_success=true): "Il filtro non è stato applicato perché il parametro "Valore filtro" ha un valore vuoto." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se il parametro "Chiave filtro" è impostato su "Seleziona uno" e il parametro "Logica di filtro" è impostato su "Uguale a" o "Contiene": "Errore durante l'esecuzione dell'azione "{action name}". Motivo: devi selezionare un campo dal parametro "Chiave filtro". Se viene fornito un valore non valido per il parametro "Numero massimo di record da restituire": "Errore durante l'esecuzione dell'azione "{action name}". Motivo: "È stato fornito un valore non valido per "Numero massimo di record da restituire": . Deve essere fornito un numero positivo"." Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "{action name}". Motivo: {0}''.format(error.Stacktrace) |
Generale |
Tabella Bacheca casi | Nome tabella: Chat disponibili Colonne della tabella:
|
Generale |
Invia messaggio di chat
Descrizione
Inviare un messaggio di chat in Microsoft Teams.
Parametri
Nome visualizzato del parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
ID chat | DDL | N/D | Sì | Specifica l'ID della chat a cui vuoi inviare un messaggio. |
Testo | Stringa | N/D | Sì | Specifica il contenuto del messaggio. |
Wait For Reply | Casella di controllo | Selezionata | Sì | Se abilitata, l'azione attende la risposta. |
Run On
Questa azione non viene eseguita sulle entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Risultato JSON
{
"id": "1632820681737",
"replyToId": null,
"etag": "1632820681737",
"messageType": "message",
"createdDateTime": "2021-09-28T09:18:01.737Z",
"lastModifiedDateTime": "2021-09-28T09:18:01.737Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": "19:5af81bea-9c9f-4f9f-8745-9df1fdba8e12_b786d3cf-e97d-4511-b61c-0559e9f4da75@unq.gbl.spaces",
"importance": "normal",
"locale": "en-us",
"webUrl": null,
"channelIdentity": null,
"policyViolation": null,
"from": {
"application": null,
"device": null,
"user": {
"id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"displayName": "ג'יימס בונד",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "text",
"content": "qqq"
},
"attachments": [],
"mentions": [],
"reactions": []
}
Bacheca casi
Tipo di risultato | Valore/Descrizione | Tipo |
---|---|---|
Messaggio di output* | L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se viene segnalato il codice di stato 201 (is_success = true): "Messaggio inviato correttamente nella chat con ID {ID chat} Microsoft Teams". Se la risposta è disponibile (is_success = true): "Messaggio inviato e risposta ricevuta nella chat con ID {ID chat} di Microsoft Teams." Messaggio asincrono:in attesa di risposta… L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore critico: "Errore durante l'esecuzione dell'azione "Invia messaggio di chat". Motivo: {0}''.format(error.Stacktrace) Se viene segnalato il codice di stato 404: "Errore durante l'esecuzione dell'azione "Invia messaggio di chat". Motivo: la chat con ID non è stata trovata in Microsoft Teams. Se si verifica il timeout: "Errore durante l'esecuzione dell'azione "Invia messaggio di Chat"." Motivo: il messaggio è stato inviato, ma l'azione è scaduta durante l'attesa di una risposta. Aumenta il timeout nell'IDE e riprova. Nota: se riprovi, l'azione invierà un altro messaggio. |
Generale |
Invia risposta al messaggio
Descrizione
Invia una risposta al messaggio del canale in Microsoft Teams.
Parametri
Parametro | Tipo | Valore predefinito | È obbligatorio | Descrizione |
---|---|---|---|---|
Nome del team | Stringa | N/D | Sì | Specifica la squadra a cui vuoi inviare la risposta. |
Nome del canale | Stringa | N/D | Sì | Specifica il canale a cui vuoi inviare la risposta. |
ID messaggio | Stringa | N/D | Sì | Specifica l'ID del messaggio a cui vuoi inviare la risposta. |
Tipo di contenuti | DDL | Testo | No | Specifica il tipo di contenuti per il messaggio. Valori possibili:
|
Testo | Stringa | N/D | Sì | Specifica il contenuto del messaggio. |
Run On
Questa azione non viene eseguita sulle entità.
Risultati dell'azione
Risultato script
Nome risultato script | Opzioni di valore | Esempio |
---|---|---|
is_success | Vero/Falso | is_success:False |
Risultato JSON
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('192c0699-fad2-4d02-88a2-84efd6369894')/channels('19%3A4649fcf41fa5417f9aa78a5840bea442%40thread.tacv2')/messages('1686652339690')/replies/$entity",
"id": "1686653341151",
"replyToId": "1686652339690",
"etag": "1686653341151",
"messageType": "message",
"createdDateTime": "2023-06-13T10:49:01.151Z",
"lastModifiedDateTime": "2023-06-13T10:49:01.151Z",
"lastEditedDateTime": null,
"deletedDateTime": null,
"subject": null,
"summary": null,
"chatId": null,
"importance": "normal",
"locale": "en-us",
"webUrl": "https://teams.microsoft.com/l/message/19%3A4649fcf41fa5417f9aa78a5840bea442%40thread.tacv2/1686653341151?groupId=192c0699-fad2-4d02-88a2-84efd6369894&tenantId=d48f52ca-5b1a-4708-8ed0-ebb98a26a46a&createdTime=1686653341151&parentMessageId=1686652339690",
"policyViolation": null,
"eventDetail": null,
"from": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.teamworkUserIdentity",
"id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"displayName": "ג'יימס בונד",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "text",
"content": "Reply"
},
"channelIdentity": {
"teamId": "192c0699-fad2-4d02-88a2-84efd6369894",
"channelId": "19:4649fcf41fa5417f9aa78a5840bea442@thread.tacv2"
},
"attachments": [],
"mentions": [],
"reactions": []
}
Bacheca casi
Tipo di risultato | Valore/Descrizione | Tipo |
---|---|---|
Messaggio di output* | L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se 201 per uno (is_success = true): print "Successfully sent a reply to the message in Microsoft Teams." L'azione deve non riuscire e interrompere l'esecuzione di un playbook: Se si verifica un errore critico: stampa "Errore durante l'esecuzione dell'azione "Invia risposta al messaggio". Motivo: {0}''.format(error.Stacktrace) Se il team non è stato trovato: print "Error executing action "Send Message Reply". Motivo: il team con nome {team name} non è stato trovato in Microsoft Teams. Controlla l'ortografia. Se il canale non viene trovato: stampa "Errore durante l'esecuzione dell'azione "Invia risposta al messaggio". Motivo: il canale con nome {channel name} non è stato trovato in Microsoft Teams. Controlla l'ortografia. Se nella risposta è presente "error": stampa "Error executing action "Send Message Reply". Motivo: {error.message}. |
Generale |
Job
Per configurare i job in Google Security Operations, vai a Risposta > Pianificatore job.
Job di rinnovo del token di aggiornamento
Lo scopo del job di rinnovo del token di aggiornamento è aggiornare periodicamente il token di aggiornamento utilizzato nell'integrazione.
Per impostazione predefinita, il token di aggiornamento scade ogni 90 giorni, rendendo l'integrazione inutilizzabile alla scadenza. Ti consigliamo di eseguire questo job ogni 7 o 14 giorni per assicurarti che il token di aggiornamento sia aggiornato.
Input del job
Per configurare il job, utilizza i seguenti parametri:
Parametri | |
---|---|
Root API di accesso | Obbligatorio
Radice dell'API utilizzata per l'autenticazione con Microsoft identity Platform. Il valore predefinito è |
Root API | Obbligatorio
Radice dell'API dell'istanza di Microsoft Graph. Il valore predefinito è |
Ambienti di integrazione | Optional
Ambienti di integrazione per i quali il job aggiorna i token di aggiornamento. Questo parametro accetta più valori come stringa separata da virgole. Racchiudi i singoli valori tra virgolette ( |
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.