註冊開發程式以及設定一些有的沒的

1. Overview：裡面有各種白痴key

2. Authentication：要設定redirect url要去那邊 （Authorization Code Flow會用到）

3. Certificates & secrets：使用CredentialClientApp (App-only access) 會用到的secret key

4. Token configuration, API permissions：設定權限會用到

取得token

什麼是MSAL? ADAL?

Scope

大致上的介紹

Microsoft Graph permissions reference - Microsoft Graph

Microsoft Graph exposes granular permissions that control the access that apps have to resources, like users, groups, and mail. As a developer, you decide which permissions for Microsoft Graph your app requests.

https://learn.microsoft.com/en-us/graph/permissions-reference

1. Microsoft Graph API：Microsoft Graph API 是一種讓你能夠讀取和寫入多種 Microsoft 365 服務的資源的方法，包括 Outlook 郵件、日曆、OneDrive 檔案、任務、Teams 聊天等。以下是一些常見的 Microsoft Graph scopes：
• User.Read：讓應用程式讀取使用者的個人資訊。
• Mail.Read：讓應用程式讀取使用者的郵件。
• Files.Read：讓應用程式讀取使用者的 OneDrive 檔案。
• Calendars.Read：讓應用程式讀取使用者的日曆。

2. Office 365 Management APIs：Office 365 Management API 提供了許多與服務相關的管理功能，例如安全和合規性中心、審計等。以下是一些常見的 Office 365 Management API scopes：
• https://manage.office.com/ActivityFeed.Read：讓應用程式讀取 Office 365 安全審計記錄。
• https://manage.office.com/ServiceHealth.Read：讓應用程式讀取 Office 365 服務狀態。

3. Azure Management APIs：Azure Management API 提供了管理 Azure 資源的能力，例如虛擬機器、網路、資源組等。以下是一些常見的 Azure Management API scopes：
• https://management.azure.com/user_impersonation：讓應用程式以使用者的身份執行 Azure Management API。

實際上使用的方法

在Python使用MSAL

一個簡單的說明和開始

1. 初始化一個 PublicClientApplication 或 ConfidentialClientApplication 物件 （詳細可以看上一篇的）。

2. 使用該物件調用相關的方法（例如 acquire_token_by_authorization_code） 進行身份驗證並取得令牌。

PublicClientApplication & ConfidentialClientApplication介紹

1. PublicClientApplication：這個類別是用於構建那些無法安全存儲客戶端密鑰的應用程式的，比如一般的桌面應用或者是移動應用。這些類型的應用程式在初始化 PublicClientApplication 物件時，只需要提供 client_id（應用程式在 Azure AD 中的識別碼）。這類應用程式將主要使用如 Device Code Flow、Interactive Flow 之類的授權流程。

2. ConfidentialClientApplication：這個類別是用於那些能夠安全存儲客戶端密鑰的應用程式的，例如運行在伺服器端的 Web 應用程式或服務。這些類型的應用程式在初始化 ConfidentialClientApplication 物件時，需要提供 client_id 和 client_secret。這類應用程式主要使用如 Authorization Code Flow、Client Credential Flow 等授權流程。

• PublicClientApplication：對應到 Delegated access

• ConfidentialClientApplication：對應到App-only access

建立App需要的參數

• client_id：這是你的應用程式在 Azure AD 中的應用程式（客戶端）ID。這是必需的，因為它讓 Azure AD 知道是哪一個應用程式正在試圖進行身份驗證或授權操作。

• authority：這是一個 URL，指向了負責處理身份驗證和授權請求的 Azure AD 的實體。如果你沒有提供這個參數，則 MSAL 會使用默認的實體（即 https://login.microsoftonline.com/common）。在多數情況下，你不需要更改這個參數，除非你需要指向特定的租戶或使用國家特定的雲。

• client_credential：這個參數在 PublicClientApplication 中並不常用，因為公開客戶端應用程式通常無法安全地存儲客戶端密鑰。然而，如果你確實有一個密鑰，並且想要用它來執行某些需要它的操作（例如 client credentials flow），那麼你可以提供這個參數。但在ConfidentialClientApplication 蠻常用的（吧）。

App依照不同的情境會有的python方法

1. Authorization Code Flow
此流程主要用於 Web 應用程式，允許伺服器端的 Web 應用程式代表用戶獲取 Access Token 和 ID Token。這需要用戶在瀏覽器中互動以獲得授權碼，然後應用程式可以將此授權碼交換為令牌。
• get_authorization_request_url(): 此方法返回一個 URL，應用程式可以引導用戶前往此 URL 以獲得授權碼。
• acquire_token_by_authorization_code(): 當用戶返回並帶回授權碼時，此方法可以將授權碼交換為令牌。

2. Device Code Flow
此流程適用於沒有瀏覽器或僅限文字輸入的設備（例如，智能電視或 IoT 設備）。在此流程中，設備將顯示一個設備碼和 URL，用戶需要在另一台有瀏覽器的設備上輸入這些信息以完成授權。
• initiate_device_flow(): 此方法初始化設備碼流程並返回一個包含設備碼和相應 URL 的字典。
• acquire_token_by_device_flow(): 應用程式需要定期呼叫此方法以檢查用戶是否已在瀏覽器中完成授權。

3. Refresh Token Flow
此流程允許應用程式使用 Refresh Token 獲得新的 Access Token。當 Access Token 過期時，此流程可以在無需用戶互動的情況下獲得新的 Access Token。
• acquire_token_silent(): 此方法使用在先前的授權過程中獲得的 Refresh Token 來獲得新的 Access Token。如果成功，此方法將返回新的 Access Token；否則，將引發一個例外，此時可能需要重新引導用戶進行互動授權。

4. Client Credentials Flow
此流程允許應用程式以其自身的身份（而不是代表用戶）來獲取 Access Token。此流程適用於僅需要 App-only access 的應用程式。
• acquire_token_for_client(): 此方法使用應用程式的 client_id 和 client_credential 來獲得 Access Token。

5. Resource Owner Password Credentials Flow
使用用戶的帳號密碼來登入，通常只能用在學校或租戶的帳號
• acquire_token_by_username_password(username, password, scopes)

Acquiring tokens - Microsoft Authentication Library for Python

There are many ways of acquiring a token. Some require user interaction through a web browser. Some don't require any user interaction.

https://learn.microsoft.com/en-us/entra/msal/python/getting-started/acquiring-tokens

Code 範例：fastAPI + Authorization code flow

• ”login”：取得microsoft的登入介面(url)

• “callback”：登入結束之後，microsoft會傳code到我們建立的callback，我們在callback藉由code取得token

• A: 把需要用的參數設定在config字典裡面

• B: 建立一個publicClientApp

• C: 使用get_authorization_request_url取得url

• D: 把url給user

• E: 同A

• F: 同B

• G: acquire_token_by_authorization_code 取得token本人

GraphAPI本人

簡介

1. Facebook 的 Graph API:
Facebook 的 Graph API 是他們核心的一部分，它允許開發者讀取、寫入和修改 Facebook 社交圖表的數據。在這裡，社交圖表基本上是指的 Facebook 的全球社交連結網絡，包括用戶（人）、他們分享的內容（例如照片、影片）、地點、應用程式、以及他們之間的各種關聯（例如朋友關係、分享行為、評論等）。
Graph API 提供了一種統一的視角來查看所有的數據，無論是個人的狀態更新、照片，還是公共頁面的貼文。開發者可以使用此 API 來建立與 Facebook 數據深度交互的應用程式，例如擷取用戶資訊、發布內容以及對已存在的數據進行更多操作。

2. Microsoft Graph API:
Microsoft Graph API 是微軟 365 的連接點，提供一個統一的可程式化的訪問點，以訪問 Microsoft 365 中的數據，包括但不限於 Office 365、Enterprise Mobility and Security、Windows 10，以及更多其他的微軟雲服務。簡單來說，Microsoft Graph API 是微軟雲的 API。
它提供了一個一致的模型來訪問豐富的數據和關係，包括用戶、郵件、日曆、聯繫人、任務、設備等等。開發者可以用這個 API 來建立對 Microsoft 365 數據進行各種操作的應用程式，比如自動化工作流程、分析數據、集成系統等等。

試用GraphAPI: Graph Explorer

Graph Explorer | Try Microsoft Graph APIs - Microsoft Graph

Try the Graph Explorer developer tool to learn about Microsoft Graph APIs. Includes code snippets, Microsoft Graph Toolkit, and Adaptive Cards integration.

https://developer.microsoft.com/en-us/graph/graph-explorer/?request=me&version=v1.0

常見功能

1. 使用者和群組： 你可以管理使用者和群組，包括創建、讀取、更新和刪除使用者或群組的信息。例如，你可以讀取使用者的郵件，或者更新使用者的個人資訊。

2. 郵件和日曆： 你可以管理使用者的郵件和日曆。例如，你可以讀取、創建、發送郵件，或者讀取、創建、更新和刪除日曆項目。

3. OneDrive 和 SharePoint 文件： 你可以讀取、創建、更新和刪除 OneDrive 和 SharePoint 中的文件和文件夾。

4. Teams： 你可以管理 Teams 中的頻道和訊息，包括讀取、創建、更新和刪除頻道或訊息。

1. Content-Type： 當你發送一個包含 JSON 內容的 POST 或 PUT 請求時，你需要添加一個 'Content-Type' 頭部並將其值設置為 'application/json'。

2. ConsistencyLevel： 當你需要進行需要一致性保證的複雜查詢時，你可以添加一個 'ConsistencyLevel' 頭部並將其值設置為 'eventual'。

3. Prefer： 當你想控制某些操作的行為時，你可以添加一個 'Prefer' 頭部。例如，當你創建一個新的資源時，你可以添加 'Prefer: return=representation' 頭部來要求服務器在回應中返回新創建的資源。

4. If-Match： 當你更新或刪除一個資源時，你可以添加一個 'If-Match' 頭部來提供資源的當前版本。這可以防止你覆蓋其他人剛剛做的更新。

針對抓取mail相關訊息的方法

Use the Outlook mail REST API - Microsoft Graph v1.0

Microsoft Graph lets your app get authorized access to a user's Outlook mail data in a personal or organization account.

https://learn.microsoft.com/en-us/graph/api/resources/mail-api-overview?view=graph-rest-1.0

1. Overview：這部分提供對於郵件 API 的總體理解， 描述了可以透過 API 實現的主要功能（如閱讀、發送郵件等）。

2. Message：Message 端點可以讓開發者讀取、創建、更新和刪除郵件。 你可以在 Message 物件中設定一些內容，比如收件人，主題，郵件正文等等。

3. Attachment：Attachment 端點提供了對郵件附件的操作。 你可以添加、查看、刪除郵件的附件。

4. Category：這允許你為郵件添加類別，方便後續查找和管理。

5. Focused Inbox：Focused Inbox 是 Outlook 的一個特性，可以將重要的郵件過濾出來。 透過 API，你可以控制哪些郵件出現在 Focused Inbox 中。

6. Mail folder：Mail folder 端點允許開發者操作郵箱的資料夾， 包括創建、刪除、重命名資料夾等等。

7. Mail search folder：這允許你創建搜索資料夾， 將符合特定條件的郵件自動添加到這個資料夾。

8. Rule：規則可以讓你自動處理特定的郵件。 比如說，你可以創建一條規則，將所有主題包含 "invoice" 的郵件移動到特定的資料夾。

9. Extended properties：這提供了一種擴展 Message 物件的方式， 可以添加額外的、自定義的屬性。

message/ List messages

List messages - Microsoft Graph v1.0

Get the messages in the signed-in user's mailbox (including the Deleted Items and Clutter folders).

https://learn.microsoft.com/en-us/graph/api/user-list-messages?view=graph-rest-1.0&tabs=http

抓特定message

message/ List attachments

List attachments - Microsoft Graph v1.0

Retrieve a list of attachment objects attached to a message.

https://learn.microsoft.com/en-us/graph/api/message-list-attachments?view=graph-rest-1.0&tabs=http

Attachment/Get attachment

Get attachment - Microsoft Graph v1.0

Read the properties and relationships of an attachment, attached to an event,

https://learn.microsoft.com/en-us/graph/api/attachment-get?view=graph-rest-1.0&tabs=http