簡介
本文檔介紹配置DTMF序列以允許使用者在思科會議伺服器(CMS)空間上執行操作的步驟。
必要條件
需求
思科建議您瞭解以下主題:
採用元件
本文中的資訊係根據以下軟體和硬體版本:
本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除(預設)的組態來啟動。如果您的網路運作中,請確保您瞭解任何指令可能造成的影響。
背景資訊
在CMS中可為空間參與者定義自定義DTMF序列,用於呼叫影響空間及其參與者的操作。例如,參與者可以使用DTMF序列切換其自己的音訊靜音、開始或停止會議串流,或結束會議。
dtmfProfile定義用於呼叫每個可用特定操作的DTMF序列。通過CMS API將dtmfProfile分配給系統/配置檔案,DTMF序列可全域性使用。通過建立對每個操作具有不同許可權的callLegProfiles,並在不同的API級別上應用它們,可以對DTMF操作的限制進行微調。
設定
1.建立dtmfProfile對象並將其全域性應用
建立dtmfProfile對象的步驟:
1.登入到CMS Web管理頁面。
2.導覽至Configuration > API。
3.導航至/api/v1/dtmfProfiles部分,並 擴大它。
4.按一下新建。
5.定義用於執行所需操作的DTMF序列。在本示例中,為toggleMuteSelfAudio和endCall操作定義DTMF序列。
6.按一下建立。
要全域性應用dtmfProfile,請執行以下操作:
1.導覽至Configuration > API。
2.導航到/api/v1/system/profiles部分並展開它。
3.按一下檢視或編輯。
4.在dtmfProfile設定中,按一下Choose並選擇以前建立的對象。
5.按一下修改。
2.微調許可權以執行DTMF操作
通過配置callLegProfiles(可以在API中的不同級別應用),可以實現對執行DTMF操作的許可權的精細控制。此圖說明所有可能的層級:
callLegProfile的應用級別決定其範圍。在較低級別分配的配置檔案會覆蓋以上設定的配置檔案。這些示例說明了如何利用該原則允許僅向特定空間或使用者呼叫DTMF操作。
僅允許特定空間中的操作
可以在/system/profiles級別建立和應用callLegProfile來取消執行DTMF操作的許可權。然後,可以在coSpace級別建立和應用另一個允許這些操作的callLegProfile,因此將許可權範圍限制到特定的coSpace(或一組coSpaces,如果應用於多個)。
1.導覽至Configuration > API。
2.導航到/api/v1/callLegProfiles部分並展開它。
3.按一下新建。
4.定位至需要禁止的操作,並將其設定為false。
5.按一下建立。
在本示例中,已建立callLegProfile,通過將endCallAllowed設定為false來禁止結束會議:
提示:如果已存在合適的callLegProfile,則可以修改它,而不是建立新檔案。
6.將其分配到系統/配置檔案,以全域性禁止此操作:
7.建立新的callLegProfile,這次允許執行操作。在本示例中,建立了callLegProfile,並將endCallAllowed設定為true:
8.導覽至Configuration > API > /api/v1/coSpaces,然後展開它。
9.找到要為其分配的coSpace,然後在callLegProfile下,選擇您建立的用於允許這些操作的coSpace。
由於此callLegProfile是在較低的API級別應用的,因此它將覆蓋以前應用於/system/profiles的callLegProfile,從而導致僅可以從此特定coSpace呼叫DTMF操作。
僅允許具有密碼的使用者執行操作
許可權範圍可以縮小到需要特殊許可權的一組使用者,如影片操作員。可以使用自己的目錄號碼建立accessMethod,以使用特定的callLegProfile(允許DTMF操作)訪問coSpace。
1.導覽至Configuration > API > /api/v1/coSpaces,然後展開它。
2.從清單中,選擇要為其建立accessMethod的coSpace。
3.在「Related objects」清單中,按一下/api/v1/coSpaces/<coSpace ID>/accessMethods鏈接:
4.在uri欄位中,輸入特權使用者可撥入此空間的號碼。
5.建立密碼。當特權使用者撥打accessMethod號碼時,他們需要輸入此代碼,後跟允許進入會議的#號。
6.在callLegProfile下,選擇允許結束呼叫的呼叫。
7.(可選)輸入accessMethod的名稱,使其可以從API資源管理器中輕鬆識別。
在此示例中,為影片操作員建立了一個編號為3001的accessMethod,以便在加入coSpace時使用(目錄編號3000已分配給coSpace,普通使用者撥打此號碼以加入此空間中的會議)。它受密碼保護,允許終止呼叫的callLegProfile以獨佔方式分配給它。
8.通過將不允許操作的callLegProfile分配給系統/配置檔案,以全域性方式應用該操作。
在本示例中,不需要將callLegProfile分配給coSpace本身。它繼承全域性應用的配置檔案,因此通過撥打coSpace號(3000)加入會議的使用者沒有通過DTMF結束呼叫的許可權。
由於此配置,影片操作員可以通過撥打accessMethod number(3001)而不是coSpace number(3000)加入會議。它們的呼叫段使用允許應用該操作的callLegProfile,因此只有它們可以使用定義的DTMF序列結束呼叫。
相關資訊
CMS 3.8 API參考指南