Skip to content

Commit dbd92b3

Browse files
CSOAR-3249 : updated the doc
1 parent 6ef4a48 commit dbd92b3

File tree

1 file changed

+54
-3
lines changed

1 file changed

+54
-3
lines changed

docs/platform-services/automation-service/app-central/integrations/microsoft-ews-daemon.md

Lines changed: 54 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,12 +43,24 @@ The Microsoft EWS Incoming Mail Daemon automatically retrieves emails. It enable
4343
* Correctly configured EWS endpoint
4444
* Valid credentials or token
4545

46-
### Limitations
47-
* Certain Outlook-specific attachments may appear as ItemAttachment instead of FileAttachment
48-
* Attachments of type ItemAttachment may lack file extensions or MIME types (e.g., content_type=None)
46+
### Limitations
47+
* Certain attachments may be represented differently, which can result in missing or inconsistent file metadata (e.g., name or type).
4948
* Mailbox rate limits may apply depending on Microsoft tenant configuration
5049

50+
## Usage
5151

52+
### Basic usage
53+
* Configure credentials (Tenant ID, Client ID, Client Secret).
54+
* Set retrieval parameters like polling frequency, folders to include/exclude.
55+
* Enable the Daemon action in a rule or playbook.
56+
* Emails are pulled automatically.
57+
58+
### Advanced usage
59+
* Use filtering parameters to narrow email scope:
60+
* Subject keywords
61+
* Sender domain
62+
* Date ranges
63+
* Enable the Daemon action in a rule or playbook.
5264

5365
## Actions
5466

@@ -172,6 +184,45 @@ import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
172184

173185
For information about Microsoft EWS, see [Microsoft Exchange Web Services documentation](https://learn.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth).
174186

187+
## API reference
188+
189+
### Configuration
190+
Environment variables or parameters:
191+
* tenant
192+
* client id
193+
* client secret
194+
* email: The service account email address
195+
* password or OAuth token: Authentication credentials
196+
* automation bridge
197+
* and other fields info based on the requirement
198+
199+
### Containment APIs
200+
201+
### Rate Limits and Quotas
202+
* Microsoft may enforce throttling based on:
203+
* Number of concurrent EWS requests
204+
* Number of items retrieved per call
205+
* Number of mailbox accesses per day/hour
206+
207+
#### Troubleshooting
208+
| Issue | Resolution | Resolution |
209+
| :-- |:-- |:-- |
210+
| No emails retrieved | Incorrect folder, filters too strict | Check filters, verify folder ID |
211+
| Authentication failed | Invalid credentials or token | Update credentials and reauthorize |
212+
213+
### FAQ
214+
215+
#### Can I filter which emails are fetched?
216+
Yes. Filtering can be applied based on folders, received time. Custom filters may be implemented depending on integration configuration.
217+
218+
#### How frequently does the Daemon poll for new messages?
219+
The polling interval is determined by the configuration within the integration setup or automation rule.
220+
221+
### Support
222+
* For issues, questions, or improvements:
223+
* Microsoft [Q&A](https://learn.microsoft.com/answers)
224+
* Review logs on the portal using log search.
225+
175226
## Category
176227

177228
Email Gateway

0 commit comments

Comments
 (0)