OneDrive の設定

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

OneDrive for Business と OneDrive personal で OneDrive 統合を有効にできます。

OneDrive を使用して、次のアクションを実行できます。

OneDrive にファイルをチェックアウトする: ファイルが OneDrive にアップロードされ、アセットが Sitecore Content Hub^TM でロックされます。
OneDrive からファイルをチェックインする: チェックアウトしたファイルが OneDrive から取り込まれ、Sitecore Content Hub^TM 内のアセットが新しいファイルで更新されます。
チェックアウトしたファイルを破棄する: ファイルが OneDrive から削除され、Sitecore Content Hub^TM 内のアセットがロック解除されます。
OneDrive にダウンロードする: ファイルは Sitecore Content Hub^TM から OneDrive にアップロードされますが、ファイルは追跡されないため、アセットはロック解除されたままになります。

設定

次から選択して、アプリ登録を作成する必要があります。

OneDrive Personal: https://apps.dev.microsoft.com/portal/register-app.
OneDrive for Business: https://portal.azure.com (詳細については、「Setup OneDrive for Business をセットアップする」を参照してください)。

OneDrive 設定を行う

チェックアウトフォルダー (checkoutsFolder) と ダウンロードフォルダー (downloadsFolder): これらのフォルダーは、チェックアウトしたファイルとダウンロードしたファイルを区別するために使用できます。空のままにすると、ファイルはルートのアプリフォルダーにアップロードされます。
logLevel: Sitecore Content Hub^TM では、アクションごとにジョブが作成されます。 loglevel を Error に設定するか、空のままにすると、ジョブターゲットは失敗したファイルに対してのみ作成されます。 loglevel を Info に設定すると、ジョブターゲットはファイルごとに作成されます。
enabled: OneDrive 統合を有効にするには、これを true に設定し、無効にするには false に設定する必要があります。
clientId と clientSecret: ユーザーがアプリ登録から受け取る個人コード。
authorizeUri と tokenUri: OneDrive for Business では、これらをユーザー固有の URI に設定する必要があります。 OneDrive personal では、既定値で問題ありません。

{
  "basic": {
    "apiUri": "https://graph.microsoft.com/",
    "apiVersion": "v1.0",
    "checkoutsFolder": "Checkouts",
    "downloadsFolder": "Downloads",
    "logLevel": "Error"
  },
  "business": {
    "enabled": true,
    "clientId": "",
    "clientSecret": "",
    "authorizeUri": "https://login.microsoftonline.com/<customkey>/oauth2/authorize",
    "tokenUri": "https://login.microsoftonline.com/<customkey>/oauth2/token"
  },
  "personal": {
    "enabled": true,
    "clientId": "",
    "clientSecret": "",
    "authorizeUri": "https://login.microsoftonline.com/common/oauth2/v2.0/authorize",
    "tokenUri": "https://login.microsoftonline.com/common/oauth2/v2.0/token"
  }
}

ポータルでアクションを有効にする方法の詳細については、「OneDrive の概要」を参照してください。

[!注] Sitecore Content Hub^TM のバージョン 3.4.0 の場合、CloudDrive 統合設定はシステム所有です。つまり、管理者アクセス権が必要です。これを更新する場合は、アカウントマネージャーに連絡する必要があります。バージョン 3.4.1 以降、この設定はシステム所有ではなくなりました。

OneDrive for Business をセットアップする

次の手順は、OneDrive for Business を統合する方法を示しています。

Azure ポータル (https://portal.azure.com) に移動します。

[!注]

Azure Active Directory (Azure AD) Microsoft のクラウドベースの ID およびアクセス管理サービスであり、従業員がログインして外部リソース (Microsoft Office 365、Azure ポータル、その他多くの SaaS アプリケーションなど) や内部リソース (社内ネットワークやイントラネット上のアプリ、組織が開発したクラウドアプリなど) にアクセスできます。
上部の検索バーを使用して、Azure Active Directory を検索して選択します。
[Azure Active Directory] ページの [管理] の下で、[アプリの登録] を選択します。
[アプリの登録] ページのトップメニューで、[+ 新規登録] オプションを選択します。
[アプリケーションの登録] ページが表示されたら、アプリケーションの登録情報を入力します。
- 名前: アプリのユーザーに表示するわかりやすいアプリケーション名を入力します。
- サポートされているアカウントタイプ: アプリケーションでサポートするアカウントを選択します。
  - この組織ディレクトリ内のアカウントのみ: 基幹業務 (LOB) アプリケーションを作成する場合は、このオプションを選択します。
  - 任意の組織ディレクトリ内のアカウント: すべてのビジネスおよび教育機関の顧客をターゲットにする場合は、このオプションを選択します。
  - 組織ディレクトリ内のアカウントと個人の Microsoft アカウント: このオプションを選択して、最も幅広い顧客をターゲットにします。
リダイレクト URI (オプション): リダイレクト URI は、OneDrive に正常にログインした後にリダイレクトされる URL です。 [Web] または [SPA - シングルページアプリケーション] のいずれかを選択します。この例では、[Web] を選択しています。 [OneDrive for Business に接続する] を使用してユーザープロファイルから OneDrive for Business にログインしている場合、リダイレクト URI には、プロファイル名も含める必要があります (例: *https://{your_sitecore_content_hub_instance}/en-us/user/myprofile*)。

必要なアドレスを見つけるには、アイコンをクリックし、メニューの [プロファイル] を選択します。このページは、新しいアプリケーションの登録時、または後で マニフェストの作成時に replyUrlsWithType 属性で使用できる正しいリダイレクト URI です。

この例では、https://stylelabs.io/en-us/user/myprofile を使用しています。
必要な詳細を入力したら、[登録] をクリックします。
Azure AD からアプリに対して一意のアプリケーション (クライアント) ID が割り当てられ、アプリケーションの概要ページが自動的に表示されます。

アプリケーション (クライアント) ID の値は、Sitecore Content Hub^TM における OneDrive 統合設定の clientId フィールドで必須です。
[管理] メニューの下の [証明書とシークレット] オプションを選択してクライアントシークレットを生成します。
[証明書とシークレット] ページで、[+ 新しいクライアントシークレット] をクリックします。
[クライアントシークレットの追加] モーダルで、[説明] テキストボックスにクライアントシークレットの説明を入力し、有効期限のオプションから有効期限日を選択します。
- 1 年
- 2 年
- 無期限
続行するには [追加] をクリックします:
アプリケーションの資格情報が更新され、シークレットの値がコピーオプションとともに表示されます。この値は、コピーして別の場所に保存しておく必要があります (後で取得することはできません)。

クライアントシークレットは、Sitecore Content Hub^TM における OneDrive 統合設定の clientSecret フィールドで必須の値です。
[管理] の下で、[マニフェスト] オプションを選択します。

Web ベースのマニフェストエディターが開き、ポータル内でマニフェストを編集できます。オプションで、[ダウンロード] を選択してマニフェストをローカルで編集し、次に [アップロード] を使用してアプリケーションに再適用できます。
アプリケーションの作成時に リダイレクト URI を追加しなかった場合、JSON ファイルで replyUrlsWithType を検索し、https://{your_sitecore_content_hub_instance}/en-us/user/myprofile の値を入力します。

replyUrlsWithType 属性は、トークンを返すときに Azure AD が出力先として受け入れる、登録済みの redirect_uri 値のリストを保持します。各 URI 値には、関連するアプリタイプの値を含める必要があります。

サポートされているタイプの値は次のとおりです。
- Web
- InstalledClient
次の例では、サポートされているタイプの値 Web をタイプの値として選択しています。

この記事を改善するための提案がある場合は、お知らせください!