目錄

簡介

必要條件

需求

採用元件

設定

SMTP設定

簡訊設定

通過SMTP的SMS網關

通過HTTP的SMS網關

通過郵件傳送帶有憑據的訪客通知

通過SMS提供憑證的訪客通知

訪客使用者（自行註冊）

通過電子郵件進行訪客審批

通過電子郵件/簡訊的訪客帳戶過期

通過電子郵件傳送的警報

通過REST API傳送簡訊

驗證

疑難排解

相關資訊

簡介

本文檔介紹如何配置Cisco Identity Services Engine(ISE)版本1.4，以便支援多個服務的電子郵件和簡訊服務(SMS)通知。

必要條件

需求

思科建議您瞭解Cisco ISE和訪客服務的基本知識。

採用元件

本檔案中的資訊是根據以下硬體和軟體版本：

- 搭載Cisco AnyConnect安全行動化使用者端的Microsoft Windows版本7，版本3.1

- Cisco Catalyst 3750X系列交換器（執行軟體版本15.0.2及更新版本）

- Cisco ISE版本1.3及更高版本

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路正在作用，請確保您已瞭解任何指令可能造成的影響。

設定

本節介紹如何配置ISE以支援各種服務的電子郵件和SMS通知。

SMTP設定

ISE必須先配置簡單郵件傳輸協定(SMTP)中繼伺服器，然後才能使用任何電子郵件服務。若要配置伺服器，請導航到管理>系統>設定> SMTP伺服器:

此伺服器應能夠接受來自ISE的任何電子郵件，而無需身份驗證或加密。

附註：對於SMTP中繼伺服器配置，思科建議您將ISE IP地址新增到例外清單(no或anonymous身份驗證)，並要求所有其它主機進行身份驗證。

簡訊設定

為了使SMS服務與ISE配合使用，您必須配置特定SMS網關。ISE支援Smtp2SMS和Http2SMS網關。預設情況下，為公認提供商預配置了9個網關（您可能需要調整這些網關）。 要配置這些設定，請導航到管理>系統>設定> SMS網關:

通過SMTP的SMS網關

配置SMTP SMS網關時，唯一的必需欄位是Provider Domain欄位，如思科身份服務引擎管理員指南1.4版中的SMS網關設定SMS電子郵件網關部分所述。

使用預設設定（空）時，SMTP API正文模板欄位的值等於$message$值。

預設消息值取決於使用的服務。對於通知服務（建立訪客帳戶時），可從發起人門戶自定義頁面（通知訪客/SMS通知）進行配置。 這是預設值：

SMTP API正文模板欄位值也可以自定義。支援的預設值的動態替換為$mobilenumber$和$message$。例如，配置測試模板$message$value時，此資料在SMTP負載中傳送：

在測試模板字串之後，$message$的值將被替換（在本示例中，用於SMS通知服務）。

SMTP API正文模板欄位值的另一個示例是test template2 $mobilenumber$。以下是使用此值時傳送的負載：

請注意$mobilenumber$和$message$變數之間的細微差異。通常，所有空格字元（空格）都會轉義並替換為+字元。使用$message$變數時，會保留這些空白字元。

在SMTP API正文模板欄位中配置了多個值的SMTP SMS網關(ClickatellViaSMTP)就是一個例子。所有這些值都是靜態的(除$message$和$mobilenumber$值外)。 提供這些值是為了表明可能調整負載並提供額外資料，而SMTP提供程式可能需要這些資料。大寫字母顯示的值應替換為提供商提供的正確值（對於通過此提供商傳送的所有電子郵件，這些值將相同）。

以下是範例：

通過HTTP的SMS網關

對於HTTP2SMS網關，輸入SMS HTTP API以使用HTTP Get請求方法：

通常，SMS提供程式應指示必須傳送的屬性和可選屬性，以及應傳送的字串型別和埠號(如果不是80)。

以下示例基於AwalJawaly SMS服務提供商，這是使用的URL結構：http://awaljawaly.awalservices.com.sa:8001/Send.aspx。

以下是必填參數：

- 請求型別(SMSSsubmitReq)

- 使用者名稱

- 密碼

- 手機號碼

- 消息

以下是可選引數：

- 原始地址

- 類型

- 交貨時間

- 有效期

- 閃爍

- 確認

- 最大積分

- 客戶端消息ID

- 使用者資料標頭(UDH)

以下是此範例中使用的URL:

http://awaljawaly.awalservices.com.sa:8001/Send.aspx?REQUESTTYPE=SMSSubmitReq&Username=&Test&&Password=123456&MOBILENO=$mobilenumber$&MESSAGE=$message$

附註：所有必填欄位都包含在上一個URL中。如果需要，可選欄位可能會新增到字串中。

以下是有關可選欄位的一些說明：

1. 使用者名稱和密碼應包含在此連結中（很遺憾，使用的是明文）。

2. 在發起人門戶的訪客建立練習中，手機號碼會自動從電話號碼欄位獲取。

3. message欄位將自動從此位置填充：發起人門戶>門戶頁面自定義>通知訪客> SMS通知>消息文本。

為資料部分啟用使用HTTP POST方法後，將使用HTTP POST請求：

如果使用POST方法，請指定內容型別，如純文字檔案/文本或application/xml。所有其他資訊應由SMS服務提供商共用。

Data欄位大多用於POST方法。在GET方法的Data欄位中使用的任何資訊都會新增到GET HTTP請求的統一資源識別符號(URI)的末尾。

以下是GET HTTP請求的URI示例：

在URL連結中未使用$message$變數，但在「資料」欄位中輸入資訊時，此資訊在GET HTTP請求的URI的開始（消息欄位）附近可見：

以下是GET HTTP請求的URI示例：

以下是有關編碼的一些註釋：

- URL欄位ââ â此欄位不是URL編碼的。訪客帳戶行動電話號碼將替換為URL。支援的動態替換為$mobilenumber$和$message$。

- 資料字段ââ â此欄位由應用程式/x-www-form-urlencoded系統進行URL編碼。

- SpaceâSpaceâUrlâ 編碼有兩種型別，它們處理空間的方式不同。第一個字元（由RFC 1738指定）將空間視為URL中的另一個非法字元，並將其編碼為%20。第二個字元(當實現application/x-www-form-urlencoded系統)將空間編碼為+字元，並用於構建查詢字串。第二個選項使用urlencode()和urldecode()函數，這兩個函式與原始對應函式(RFC 1738)不同，只因為它們將空間編碼為加號(+)，而不是序列%20。由於ISE使用application/x-www-form-urlencoded system進行Data欄位加密，因此空間加密為+字元。

附註：如果直接在URL連結中使用$message$變數，或者僅在「資料」欄位中使用$message$變數，則從SMS通知(門戶自定義頁面> SMS通知)下的消息文本中獲取資訊。 Message文本欄位中的所有資料均採用URL編碼。

以下是兩個範例：

以下是GET HTTP請求的URI示例：

附註：GET方法不支援HTTPS（僅通過POST方法）。

通過郵件傳送帶有憑據的訪客通知

通過發起人門戶建立訪客帳戶的使用者可以選擇向特定使用者傳送帶有憑據的電子郵件通知：

此電子郵件通過先前配置的SMTP中繼傳送到訪客電子郵件地址。發起人可以提供作為自使用的任何電子郵件。如果發起人在帳戶建立期間未提供訪客電子郵件地址，則ISE會返回此圖形使用者介面(GUI)錯誤：

Unable to send email.

SMTP伺服器策略決定是接受還是丟棄此類電子郵件。例如，可以配置伺服器以便只接受來自域example.com的電子郵件。

通過SMS提供憑證的訪客通知

要使用此選項，發起人必須位於啟用該許可權的發起人組中：

Send SMS notifications with guests' credentials

預設發起人組(ALL_ACCOUNTS)沒有禁用該許可權。若要變更此項，請導覽至Guest Access > Configure > Sponsor Groups > ALL_ACCOUNTS:

當您通過SMS選擇通知時，預設情況下沒有選擇特定SMS提供商的選項，因此會使用預設的SMS提供商。若要更改此項，您可以自定義發起人門戶。

要自定義發起人門戶，請導航至Guest Access > Configure > Sponsor Portals > Sponsor Portal。然後，您可以選擇Portal Page Customization選項，並向下滾動至Create Account for Known Guests:

在右窗格中，將值從Previous更改為Settings，然後為該頁面選擇所需的（多個）SMS提供程式：

自定義Guest portal Create Account for Known Guest頁面後，使用該門戶的發起人可以選擇在建立訪客帳戶期間選擇SMS提供程式。此提供程式用於更多的SMS通知：

當SMS網關無法訪問或返回錯誤時，ISE GUI會傳送通知：

Unable to send SMS.

附註：建立使用者時不會傳送SMS，但在使用者建立完成後按一下Notification按鈕時不會傳送SMS。

訪客使用者（自行註冊）

訪客帳戶可通過自助註冊訪客門戶自動建立。訪客使用者可以建立自己的帳戶：

它們會在同一網頁上預設提供憑證：

這些憑證也可以通過電子郵件或SMS傳送。

導航到Guest Access > Configure > Guest Portals > Self Registered Guest Portal > Self Registration Page Settings，以便為特定自註冊訪客允許多個SMS網關：

訪客可以在帳戶建立期間選擇SMS提供程式。用於向其行動電話提供憑證：

註冊完成後，密碼將顯示在下一頁上。如果不希望這樣做，您可以從門戶的Self Registration Success Page部分禁用它。在同一頁面中，您還可以允許訪客通過電子郵件或簡訊手動傳送通知：

為了通過郵件或SMS（或同時使用兩者）自動傳遞憑據，請自定義Self Registration Page Settings的最後一部分：

在這種情況下，必須在建立訪客帳戶期間輸入電子郵件地址和電話號碼。

這是唯一可以自動傳送通知的訪客流（在使用者註冊後立即傳送）。 當訪客使用者帳戶由發起人建立時，此選項不可用，並且只有在發起人手動按一下Notification按鈕之後才會傳送通知。

通過電子郵件進行訪客審批

如上一節所述，訪客可以自行註冊並自動註冊帳戶。但是，還可以為此流程啟用發起人批准。

在這種情況下，發起人收到必須批准的電子郵件（按一下電子郵件中的特定連結）。 只有到那時才會啟用訪客帳戶。若要設定此功能（預設為停用），請導覽至Guest Access > Configure > Guest Portals > Self Registered Guest Portal > Self Registration Page Settings，然後啟用Require self-registered guests to be approved選項：

您還必須提供能夠批准訪客帳戶的發起人的電子郵件地址。

以下是可從Guest Email Settings頁面配置的一些其他設定：

這些設定適用於所有型別的訪客通知（不僅是發起人批准的）。

通過電子郵件/簡訊的訪客帳戶過期

帳戶即將到期時，可以通知訪客使用者。若要設定此（根據訪客型別），請導覽至Guest Access > Guest Types > Contractor:

作為承包商的所有訪客將在帳戶到期前三天收到通知。此通知可以通過簡訊和/或電子郵件傳送。可以選擇特定於SMS的提供程式，並將用於所有來賓（即使特定來賓是自行註冊的，並允許使用不同的SMS提供程式）。

在同一部分中，有一個Send test email to me at選項。這樣就能夠測試SMTP伺服器的可用性和配置。提供電子郵件地址後，系統隨即會傳送此電子郵件：

通過電子郵件傳送的警報

ISE能夠傳送電子郵件以通知檢測到的系統警報。若要啟用此功能，請導航到Administration > System > Alarm Settings > Alarm Notification，然後提供From和To電子郵件地址：

確保從警報配置部分啟用特定警報：

啟用並觸發警報後，會傳送電子郵件。以下是傳送的典型警報的示例：

ISE Alarm : Warning : No Accounting messages in the last 15 mins

No Accounting Start

Details :

No Accounting messages in the last 15 mins

Description :

No Accounting messages have been received from Network Device(s) in the past 15 minutes

for any of the session(s) authorized by ISE Policy Service Nodes

Suggested Actions :

Ensure RADIUS accounting is configured on the Network Device(s), Check Network Device(s)

configuration for local Authorization

*** This message is generated by Cisco Identity Services Engine (ISE) ***

Sent By Host : ise13

通過REST API傳送簡訊

ISE允許使用訪客REST API來建立訪客使用者。使用正確的SMS提供程式建立訪客使用者後，就可以使用訪客REST API傳送SMS。以下是範例：

PUT https://<ISE-ADMIN-NODE>:9060/ers/config/guestuser/sms/444/portalId/

ff2d99e0-2101-11e4-b5cf-005056bf2f0a

Authorization: Basic xxxxxxxxxxxxxxxxxxx

Accept:a pplication/vnd.com.cisco.ise.identity.guestuser.2.0+xml

在本示例中，444是訪客使用者ID，而長字串(ff2d99e0-2101-11e4-b5cf-005056bf2f0a)是門戶ID（發起人門戶）。

附註：需要正確發起人使用者的基本HTTP授權。有關詳細資訊，請參閱API參考指南。

驗證

目前沒有適用於此組態的驗證程序。

疑難排解

目前尚無適用於此組態的具體疑難排解資訊。

相關資訊

- 思科身份服務引擎管理員指南，版本1.3

- Cisco Identity Services Engine管理員指南，版本1.â4配ââ訪客接入

- Cisco身份識別服務引擎API參考指南，版本1.â4ââ向訪客使用者傳送SMS文本

- Cisco Identity Services Engine管理員指南，1.3版â,â âSMS網關設定

- 管理Cisco ISE

- 技術支援與文件 - Cisco Systems