mirror of https://github.com/caronc/apprise
Updated Notify_office365 (markdown)
parent
0e488ac3c3
commit
4692a6302e
|
@ -1,7 +1,7 @@
|
|||
## Office 365 Notifications
|
||||
* **Source**: n/a
|
||||
* **Icon Support**: no
|
||||
* **Attachment Support**: no
|
||||
* **Attachment Support**: Yes
|
||||
* **Message Format**: Text
|
||||
* **Message Limit**: 32768 Characters per message
|
||||
|
||||
|
@ -9,33 +9,32 @@
|
|||
|
||||
You will need to have a valid Microsoft Personal Account AND you will require Administrative access unfortunately (to access the **Mail.Send** Application Permission). More details can be [found here](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-protocols-oauth-client-creds) about registering your app with Azure.
|
||||
|
||||
1. From the [**Azure Portal**](https://portal.zure.com/) go to **Microsoft Active Directory** -> **App Registrations** ([alt link](https://apps.dev.microsoft.com/portal/register-app))
|
||||
* Use the search bar at the top of the Azure Portal and type "Azure Active Directory." if you do not see it in front of you.
|
||||
1. From the [**Azure Portal**](https://portal.zure.com/) go to **App Registrations** ([alt link](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade))
|
||||
* Use the search bar at the top of the Azure Portal and type `App Registrations`.
|
||||
* If you still can't access anything, it's possible your organisation restricts you from doing so. You may need to reach out to to your administrator in order to proceed.
|
||||
1. Click **new** -> _give any name (your choice) in Name field_ -> select _personal Microsoft accounts only_ --> **Register**
|
||||
1. Click **Register an application**
|
||||
* _give any name (your choice) in Name field_
|
||||
* select _personal Microsoft accounts only_
|
||||
* Click **Register**
|
||||
1. From here (the **Overview** panel) you can acquire both the Directory (`tenant`) ID and the Application (`client_id') you will need.
|
||||
1. To create your `client_secret` , go to **Active Directory** -> **Certificate & Tokens** -> **New client secret**
|
||||
* The `client_secret` is an auto-generated string which may have `@` and/or `?` character(s) in it. You will need to encode these characters to when pasting this into your Apprise URL. See the note section above for more details on how to do this.
|
||||
1. Now need to set permission **Active directory** -> **API permissions** -> **Add permission**.
|
||||
1. Click on **Microsoft Graph**
|
||||
1. Click on **Application Permissions** and search for **Mail.Send**; You will want to check this box too on the match found.
|
||||
1. Set the Redirect URI (Web) to the following: `https://login.microsoftonline.com/common/oauth2/nativeclient`
|
||||
1. You can do this from the **Authentication** -> **Add a platform**
|
||||
1. Choose **Web Application**.
|
||||
1. Enter the URI `https://login.microsoftonline.com/common/oauth2/nativeclient`
|
||||
1. Now you're good to go. :slightly_smiling_face:
|
||||
|
||||
## Syntax:
|
||||
|
||||
- `o365://{tenant_id}:{account_email}/{client_id}/{client_secret}/`
|
||||
- `o365://{tenant_id}:{account_email}/{client_id}/{client_secret}/{targets}`
|
||||
- `o365://{account_email}/{tenant_id}/{client_id}/{client_secret}/`
|
||||
- `o365://{account_email}/{tenant_id}/{client_id}/{client_secret}/{targets}`
|
||||
|
||||
### Parameter Breakdown
|
||||
| Variable | Required | Description
|
||||
| ----------- | -------- | -----------
|
||||
| tenant_id | Yes | The **Tenant ID** Associated with your Azure Application you created. This can also be referred to as your **Directory ID**.
|
||||
| account_email | Yes | The **Email** Associated with your Azure account.
|
||||
| client_id | Yes | The **Client ID** Associated with your Azure Application you created. This can also be referred to as your **Application ID**.
|
||||
| client_id | Yes | The **Client ID** (also referred to as an Application ID) associated with your Azure Application you created. This can also be referred to as your **Application ID**.
|
||||
| client_secret | Yes | You will need to generate one of these; this can be done through the Azure portal (Also documented below).
|
||||
| from | No | If you want the email address *ReplyTo* address to be something other then your own email address, then you can specify it here.
|
||||
| to | No | This will enforce (or set the address) the email is sent To. By default the email is sent to the address identified by the `account_email`
|
||||
|
@ -57,5 +56,5 @@ Send a email notification to our your Office 365 account:
|
|||
# Assuming our {client_id} is zz-yy-xx-ww
|
||||
# Assuming our {client_secret} is rt/djd/jjd
|
||||
apprise -vv -t "Test Message Title" -b "Test Message Body" \
|
||||
o365:///ab-cd-ef-gh:chuck.norris@roundhouse.kick/zz-yy-xx-ww/rt/djd/jjd
|
||||
o365:///chuck.norris@roundhouse.kick/ab-cd-ef-gh/zz-yy-xx-ww/rt/djd/jjd
|
||||
```
|
Loading…
Reference in New Issue