廃止予定: 役割名によるアクセス制御


告知日 廃止予定日
2017年8月9日 2017年11月15日

現在、パブリックAPIのエンドポイントには、特定の名前の役割が割り当てられているユーザーがアクセスできるものがあります。この機能は削除され、正しい権限を持つユーザーに対してのみアクセスが許可されます。PureCloud UIのいくつかのビューはこれらのエンドポイントとやり取りするため、UIのみを使用するユーザーでも影響を受ける可能性があります。

この機能に関するGenesysの2017年8月9日からの動き:

  • リソースセンターから、特定の名前の役割が割り当てられているユーザーへのアクセスを許可するパブリックAPIのドキュメントを削除します。

この機能に関するGenesysの2017年11月15日からの動き:

  • ユーザーに特定の名前の役割が割り当てられていることを確認して、パブリックAPIでのアクセスを許可しなくなります。
  • PureCloudから機能は削除されます。

よくある質問

私に影響はありますか?

ほとんど影響ない可能性があります。Genesys は継続的に役割名に基づくアクセスを監視し、サポートおよびアカウント管理チームはお客様と協力して問題の解決を行います。

どのAPIが機能廃止の影響を受けますか?

以下のリストは、現在アクセスを許可している役割名とアクセスに必要な権限と変更されるパブリックAPIエンドポイントのリストです。

API エンドポイント Verbs 必要な権限 Allowed role name Functionality
API エンドポイント Verbs 必要な権限 Allowed role name Functionality
api/v2/evaluations/favoritetemplates/{templateId} DELETE quality:evaluationForm:edit qualityAdmin Remove a question template from the favorites toolbar.
api/v2/evaluations/favoritetemplates GET, POST quality:evaluationForm:edit qualityAdmin Get a list of question templates from the favorites toolbar or add a question.
api/v2/evaluations/templates/{templateId} DELETE, GET, PUT quality:evaluationForm:edit qualityAdmin Delete, view, or edit a question template.
api/v2/evaluations/templates GET, POST quality:evaluationForm:edit qualityAdmin Get a list of question templates or create a new question template.
api/v2/recording/mediaretentionpolicies DELETE recording:retentionPolicy:delete qualityAdmin Bulk delete media retention policies.
api/v2/recording/mediaretentionpolicies GET recording:retentionPolicy:view qualityAdmin Get a list of media retention policies.
api/v2/recording/mediaretentionpolicies POST recording:retentionPolicy:add qualityAdmin Create a media retention policy.
api/v2/recording/mediaretentionpolicies/{policyId} DELETE recording:retentionPolicy:delete qualityAdmin Delete a media retention policy.
api/v2/recording/mediaretentionpolicies/{policyId} GET recording:retentionPolicy:view qualityAdmin View a media retention policy.
api/v2/recording/mediaretentionpolicies/{policyId} PATCH recording:retentionPolicy:edit qualityAdmin Edit a media retention policy.
api/v2/recording/mediaretentionpolicies/{policyId} PUT recording:retentionPolicy:edit qualityAdmin Edit a media retention policy.
api/v2/conversations/{conversationId} GET conversation:communication:view ** admin, supervisor, qualityEvaluator View another users’s conversation.
api/v2conversations/*/{conversationId}/participants/{participantId} PATCH conversation:call:record *** Supervisor
api/v2/languages/{languageId} DELETE, GET routing:skill:manage admin, supervisor, agent View or delete a language.
api/v2/languages GET, POST routing:skill:manage admin, supervisor, agent Ceate a language or get a list of languages.
api/v2/quality/forms/{formId} DELETE quality:evaluationForm:delete qualityAdmin Delete an evaluation form.
api/v2/quality/forms/{formId} GET quality:evaluationForm:view qualityAdmin View an evaluation form.
api/v2/quality/forms/{formId} PUT quality:evaluationForm:edit qualityAdmin Edit an evaluation form.
api/v2/quality/forms/{formId}/versions GET quality:evaluationForm:view qualityAdmin View an evaluation form’s revisions.
api/v2/quality/forms GET quality:evaluationForm:view qualityAdmin Get a list of evaluation forms.
api/v2/quality/forms POST quality:evaluationForm:create qualityAdmin Create an evaluation form.
api/v2/quality/publishedforms/{formId} GET quality:evaluationForm:view qualityAdmin Get a published evaluation form.
api/v2/quality/publishedforms GET quality:evaluationForm:view qualityAdmin Get a list of published forms.
api/v2/quality/publishedforms POST quality:evaluationForm:create qualityAdmin Publish an evaluation form.
api/v2/routing/languages/{languageId} DELETE, GET routing:skill:manage admin, supervisor, agent View or delete a language.
api/v2/routing/languages GET, POST routing:skill:manage admin, supervisor, agent Ceate a language or get a list of languages.
api/v2/routing/skills/{skillId} DELETE, GET routing:skill:manage admin, supervisor, agent View or delete a skill.
api/v2/routing/skills GET, POST routing:skill:manage Supervisor Ceate a language or get a list of skills.
api/v2/analytics/conversations/aggregates/query GET analytics:conversationAggregate:view Supervisor View analytics conversation aggregate data.
api/v2/analytics/conversations/details/query GET analytics:conversationDetail:view Supervisor View analytics conversation detail data.
api/v2/analytics/conversations/{conversationId}/details GET analytics:conversationDetail:view Supervisor View analytics conversation detail data.
api/v2/analytics/conversations/{conversationId}/details/properties POST analytics:conversationProperties:index Supervisor Index analytics conversation properties data.
api/v2/analytics/evaluations/aggregates/query GET analytics:evaluationAggregate:view Supervisor View analytics evaluation aggregate data.
api/v2/analytics/queues/observations/query GET analytics:queueObservation:view Supervisor View analytics queue observation data.
api/v2/analytics/users/aggregates/query GET analytics:userAggregate:view Supervisor View analytics user aggregate data.
api/v2/analytics/users/details/query GET analytics:userDetail:view Supervisor View analytics user detail data.
api/v2/analytics/users/observations/query GET analytics:userObservation:view Supervisor View analytics user observation data.
api/v2/stations/{stationId}/associateduser DELETE telephony:plugin:all admin, telephonyAdmin Unassign a user assigned to a station.
api/v2/locations/{locationId} GET telephony:plugin:all admin, telephonyAdmin View a location.
api/v2/geolocations/settings PATCH telephony:plugin:all admin, telephonyAdmin Update an organizations’ Geolocation Settings.
api/v2/telephony/providers/edges/* (ANY) telephony:plugin:all admin, telephonyAdmin Manage telephony edges.
api/v2/voicemail/policy GET, PUT telephony:plugin:all admin, telephonyAdmin View or update voicemail policies.
api/v2/voicemail/userpolicies/{userId} GET, PATCH telephony:plugin:all admin, telephonyAdmin View or update a user’s voicemail policy.
api/v2/architect/ivrs/{ivrId} DELETE, GET, PUT telephony:plugin:all admin, telephonyAdmin Delete, view, or edit an IVR.
api/v2/architect/ivrs GET, POST telephony:plugin:all admin, telephonyAdmin Create an IVR or view a list of IVRs.
api/v2/architect/schedulegroups/{scheduleGroupId} DELETE, GET, PUT telephony:plugin:all admin, telephonyAdmin Delete, view, or edit a schedule group.
api/v2/architect/schedulegroups GET, POST telephony:plugin:all admin, telephonyAdmin Create a schedule group or view a list of schedule groups.
api/v2/architect/schedules/{scheduleId} DELETE, GET, PUT telephony:plugin:all admin, telephonyAdmin Delete, view, or edit a schedule.
api/v2/architect/schedules GET, POST telephony:plugin:all admin, telephonyAdmin Create a schedule or view a list of schedule.
api/v2/users/{userId}/station/defaultstation/{stationId} PUT telephony:plugin:all admin, telephonyAdmin Set a user’s default station.
api/v2/users/{userId}/station/defaultstation/ DELETE telephony:plugin:all admin, telephonyAdmin Clear a user’s default station.

この機能廃止のために準備することはありますか?

私たちがお客様の組織で修正を行う必要があると認識した場合、Genesysの従業員がお客様に連絡します。しかし、Genesysは、ユーザーの活動状況に基づいて組織に修正を行う必要があることを認識しているため、影響を受ける可能性のある組織やユーザーをすべて特定できない場合があります。組織の管理ユーザーは、組織の役割の構成を確認し、リストされた機能が必要なユーザーに、適切な権限を持つ役割が割り当てられていることを確認する必要があります。

この廃止予定について、サポートが必要な場合や質問がある場合、以下にご連絡ください。

For information on how to contact support, see PureCloud Customer Care.