Custom OAuth profilesのスコープ ​

Workatoで定義するスコープは、管理者がHubSpotアプリで設定するスコープと一致するか、そのサブセットである必要があります。これにより、Custom OAuth profilesを使用してWorkatoとHubSpotの間でコネクションを正常に確立できます。スコープの不一致により、HubSpotコネクションの設定エラーが発生する場合があります。この追加のセキュリティ対策は、2024年10月21日以降HubSpotで必須です。

Workatoユーザーは、コネクションのセットアップ中にAdvanced settings（詳細設定）でスコープを選択できます。これらのスコープは、HubSpotコネクションの確立時に要求されます。

管理者は、HubSpotアプリのapp-hsmeta.jsonファイルのauthオブジェクトでスコープを設定します。公開アプリで使用できるスコープタイプの詳細については、HubSpotのスコープドキュメントを参照してください。

設定アプローチ ​

管理者は、次のいずれかのアプローチを使用してHubSpotでスコープを設定できます。選択するアプローチは、内部ユーザー用にスコープを設定するのか、顧客にサービスを提供するWorkato Embeddedパートナーであるのかによって異なります。

デフォルトのスコープを使用し、オンデマンドで追加 ​

デフォルトのスコープを使用し、必要に応じて追加のスコープを割り当てることができます。このアプローチは、WorkatoからHubSpotに接続する際にAdvanced settings（詳細設定）でスコープを調整しないユーザーと連携する管理者によく使用されます。

チーム内の誰もスコープを調整しない限り、エラーなしでコネクションを確立できます。コネクションの設定中に誰かがスコープを調整すると、コネクションはエラーで失敗します。この場合、HubSpot Custom OAuthアプリの所有者に新しいスコープの追加を依頼できるHubSpot管理者に連絡する必要があります。または、Workatoサポートに連絡することもできます。スコープが同期されるまで、HubSpotへのコネクションを確立できません。

管理者は、次のスコープをHubSpotで任意として追加する必要があります。これらはWorkatoのコネクションによってデフォルトで要求されるためです:

最小権限の原則 ​

管理者であり、セキュリティのベストプラクティスに従ってHubSpotカスタムOAuthアプリを設定できる場合は、最小権限の原則アプローチが適しています。このアプローチは、顧客がそのプロファイルを使用してHubSpotに接続することを想定しているEmbeddedパートナーには適していません。

管理者はユーザーと協力して、コネクター内の関連するトリガーとアクションを特定します。管理者はこの入力を使用して、HubSpot OAuthアプリで適切なスコープを選択し、任意としてマークします。アプリが更新された後、ユーザーは同じスコープを使用してWorkatoでHubSpotコネクションを設定します。この設定により、アクセスは必要なデータのみに制限され、ユーザーが自分のロール外のHubSpot情報を表示できないようになります。

すべてのスコープ ​

すべてのスコープアプローチを使用する場合、管理者は利用可能なすべてのスコープを任意として設定する必要があります。これにより、ユーザーがコネクション設定中に追加のスコープを設定する際に発生する可能性のあるコネクションエラーを排除できます。任意のスコープの次のリストを参照してください。

スコープの完全なリスト ​

ユーザーがWorkatoでHubSpotコネクションを設定するときに選択できるスコープは次のとおりです。

• accounting
• account-info.security.read
• actions
• analytics.behavioral_events.send
• automation
• automation.sequences.enrollments.write
• automation.sequences.read
• behavioral_events.event_definitions.read_write
• business_units_view.read
• business-intelligence
• cms.domains.read
• cms.domains.write
• cms.functions.read
• cms.functions.write
• cms.knowledge_base.articles.publish
• cms.knowledge_base.articles.read
• cms.knowledge_base.articles.write
• cms.knowledge_base.settings.read
• cms.knowledge_base.settings.write
• cms.membership.access_groups.read
• cms.membership.access_groups.write
• cms.performance.read
• collector.graphql_query.execute
• collector.graphql_schema.read
• communication_preferences.read
• communication_preferences.read_write
• communication_preferences.statuses.batch.read
• communication_preferences.statuses.batch.write
• communication_preferences.write
• content
• conversations.custom_channels.read
• conversations.custom_channels.write
• conversations.read conversations.write
• conversations.visitor_identification.tokens.create
• crm.dealsplits.read_write
• crm.export
• crm.import
• crm.lists.read
• crm.lists.write
• crm.objects.appointments.read
• crm.objects.appointments.write
• crm.objects.carts.read
• crm.objects.carts.write
• crm.objects.commercepayments.read
• crm.objects.companies.read
• crm.objects.companies.write
• crm.objects.contacts.write
• crm.objects.courses.read
• crm.objects.courses.write
• crm.objects.custom.read
• crm.objects.custom.write
• crm.objects.deals.read
• crm.objects.deals.write
• crm.objects.feedback_submissions.read
• crm.objects.goals.read
• crm.objects.goals.write
• crm.objects.invoices.read
• crm.objects.invoices.write
• crm.objects.leads.read
• crm.objects.leads.write
• crm.objects.line_items.read
• crm.objects.line_items.write
• crm.objects.listings.read
• crm.objects.listings.write
• crm.objects.marketing_events.read
• crm.objects.marketing_events.write
• crm.objects.orders.read
• crm.objects.orders.write
• crm.objects.owners.read
• crm.objects.partner-clients.read
• crm.objects.partner-clients.write
• crm.objects.products.read
• crm.objects.products.write
• crm.objects.quotes.read
• crm.objects.quotes.write
• crm.objects.services.read
• crm.objects.services.write
• crm.objects.subscriptions.read
• crm.objects.subscriptions.write
• crm.objects.users.read
• crm.objects.users.write
• crm.pipelines.orders.read
• crm.pipelines.orders.write
• crm.schemas.appointments.read
• crm.schemas.appointments.write
• crm.schemas.carts.read
• crm.schemas.carts.write
• crm.schemas.commercepayments.read
• crm.schemas.companies.read
• crm.schemas.companies.write
• crm.schemas.contacts.read
• crm.schemas.contacts.write
• crm.schemas.courses.read
• crm.schemas.courses.write
• crm.schemas.custom.read
• crm.schemas.custom.write*
• crm.schemas.deals.read
• crm.schemas.deals.write
• crm.schemas.invoices.read
• crm.schemas.invoices.write
• crm.schemas.line_items.read
• crm.schemas.listings.read
• crm.schemas.listings.write
• crm.schemas.orders.read
• crm.schemas.orders.write
• crm.schemas.quotes.read
• crm.schemas.services.read
• crm.schemas.services.write
• crm.schemas.subscriptions.read
• crm.schemas.subscriptions.write
• ctas.read
• e-commerce
• external_integrations.forms.access
• files
• files.ui_hidden.read
• forms
• forms-uploaded-files
• hubdb
• integration-sync
• marketing-email
• marketing.campaigns.read
• marketing.campaigns.revenue.read
• marketing.campaigns.write
• media_bridge.read
• media_bridge.write
• sales-email-read
• scheduler.meetings.meeting-link.read
• settings.billing.write
• settings.currencies.read
• settings.currencies.write
• settings.security.security_health.read
• settings.users.read
• settings.users.teams.read
• settings.users.teams.write
• settings.users.write
• social
• tax_rates.read
• tickets
• timeline
• transactional-email