Procore との統合で、自社データにアクセスするにはどうすればよいですか?

最後の更新
PDFとして保存

背景

Procore のアプリケーション・プログラミング・インタフェース (API) を使用すると、他のソフトウェアを Procore アプリケーションに統合できます。多くの統合は、「Procore マーケットプレース」を通じて利用できます。カスタム統合を構築したり、第三者の開発者と契約して会社向けの統合を構築したりすることもできます。Procore との統合は、「アプリケーション」と呼ばれることもあります。

答え

どのような種類の統合を実装しているかに関係なく、統合が会社の Procore アカウントのデータにアクセスするために使用できる承認フローは２種類あります。統合の開発者は、統合が目的どおりに機能するように、いずれか１つ、または両方を組み合わせて選択します。

認証コード

特定のユーザーの Procore 権限に依存するアプリケーションは、この認証フローを使用します。

この種類の承認フローを使用するアプリケーションは、特定のユーザーに代わって動作します。各ユーザーはまず、独自のログイン認証情報を使用して、アプリケーションにログインする必要があります。ログインに成功すると、アプリケーションはユーザーの Procore 権限に従って、Procore と対話できるようになります。これらの種類のアプリケーションは、アプリケーションを使用する個人と同じプロジェクトと情報にアクセスできます。

たとえば、管理者ユーザーが会社の Procore アカウント用のアプリケーションをインストールし、ユーザー Jane がそのアプリケーションにユーザーとしてログインすると、そのアプリケーションは Jane と同じ Procore の案件を参照して操作できるようになります。ユーザー John も、Procore の同じ会社メンバーとして同じアプリケーションにログインした場合、Jane とは異なる権限で、そのアプリケーションは John ができることだけを参照および操作できます。

DMSA

開発者管理サービスアカウント (DMSA) を使用するアプリケーションは、この承認フローを使用します。

DMSA は Procore ディレクトリ内のユーザーとして表示され、Procore アカウントにログインして会社のデータとやり取りするための統合手段として機能します。開発者はアプリケーションが機能するために必要な権限を決定し、インストール時に DMSA ユーザーにそれらの権限が既定で割り当てられます。インストール時に、Procore 管理者にはアプリケーションに必要な権限が通知され、インストールを承認するか拒否するかを選択できます。

この種類のアプリケーションは、どのユーザーが操作しているかに関係なく、会社のデータに対して同じ権限を持ちます。この承認フローは、データを可能な限り緊密に同期させることを目的として、接続されたシステム間でデータを定期的に同期するアプリケーションによく使用されます。この種類のアプリケーションは、開発者が DMSA と組み合わせて認証コードフローを使用することを選択しない限り、特定のユーザーに代わって Procore でアクションを実行することはできません。