Company/Classroom/Enterprise 設定 - 開発者

1. Click the OAuth applications tab on the Developer page to see a list of all your apps:

   

2. [新しい OAuth アプリケーションを作成] ボタンをクリックします。

3. フォームの次の項目を記入します。

   • 名前 - ユーザーに表示されるアプリケーションの名前。

   • プライマリ形式 - アプリケーションを一意に識別し、Onshape サーバーに保存される可能性のあるデータのマーカーとなる文字列 (例: com.example.example)。アプリケーションの登録後は変更できず、ユーザーには表示されません。

   • 概要 - データへのアクセス許可をアプリケーションに付与するよう要求された際にユーザーに表示されるアプリケーションの説明。

   • リダイレクト URL - 認証後にリダイレクトされる URL。アプリケーションランディングページ。

     • アプリケーションでは、OAuth プロトコル交換で使用される URL を少なくとも 1 つ指定する必要があります。

     • This URL must also use SSL (a URL that begins with https), with two exceptions applicable for installed desktop applications: http://localhost:<port> and urn:ietf:wg:oauth:2.0:oob.

   • タイプ - アプリケーションのタイプ: [統合クラウドアプリ]、[接続されたクラウドアプリ]、[接続されたデスクトップアプリ] のいずれかです。

   • OAuth URL - ユーザーを認証するための OAuth2 プロセスの開始に使用される URL。詳細は、開発者ドキュメント: OAuth2 を参照してください。

     • デプロイしたアプリケーションの URL を含める必要があります。

     • これは、Onshape のアプリケーションページから呼び出される最初の URL です。

     • この URL でホストされているページは、OAuth 認証を処理する必要があります。アプリケーションのサーバーがユーザーに代わって認証されると、そのユーザーはアプリケーションのコンテンツにリダイレクトされます。

     • アプリをまだデプロイしていない場合は、ローカルでの作業用にこのフィールドを空白のままにして、後で更新できます。

       一般に公開するために Onshape App Store に提出されるすべてのアプリケーションは、OAuth2 で正しく認証する必要があります。詳細は、開発者ドキュメント: OAuth2 を参照してください。

   • 設定

     • 共同作業をサポート - アプリケーションの開発時に、他のユーザーとの共同作業を行う場合はオンにします。

   • 権限 - 以下のアクセス許可の範囲を参照してください。

4. [アプリケーションを作成] をクリックします。

5. ウィンドウから OAuth のシークレットキーをコピーします。

   このシークレットキーに再度アクセスすることはできません。このシークレットキーはユーザー個人とそのアプリだけのものです。機密性の高いパスワードと同様に保護し、ソースコードにチェックインしないでください。

6. The app's OAuth application entry appears with the Details tab active. Selecting the app name on the OAuth applications tab now brings you to this screen.

この画面のタブを使って次のことを行います。

• 詳細:

  • アプリ用のストアエントリを作成する

  • アプリの所有権を引き継ぐ

  • Delete the application

• 設定: アプリの設定を管理する

• キーとシークレット:
  • OAuth クライアント識別キーをコピーする
  • 新しい OAuth クライアントシークレットキーを再生成する

• アクセス許可: アプリのアクセス許可の範囲を変更する

• 拡張機能: アプリの拡張機能を管理する

• Onshape OAuth: Onshape の認証を管理する

• 外部 OAuth: サードパーティの認証を管理する

OAuth2 による適切な認証やローンチのチェックリストの記入について詳しくは、Onshape 開発者向けドキュメントを参照してください。実例については、Hello World のチュートリアルを参照してください。

1. Click the OAuth applications tab on the Developer page, then select your application.

2. [拡張機能] タブをクリックします。

   

3. [拡張機能を追加] をクリックします。

4. フォームの次の項目を記入します。

   • 名前: 長すぎる場合は、UI で切り捨てられます。

   • 説明 (オプション): Onshape UI には表示されませんが、認証の許可プロセスでは表示される場合があります。

   • 場所: Onshape UI の拡張機能が存在する場所。

     • 開発者向けドキュメントのサポートされている場所とコンテキストを参照してください。

     • アプリケーションごとに作成できる要素タブの拡張は 1 つだけです。

   • コンテキスト: 一部の場所は、Part Studio の内部など、選択のコンテキストで機能します。

     • 開発者向けドキュメントのサポートされている場所とコンテキストを参照してください。

   • アクションURL: UI を埋め込む場所では、表示するページのアドレスをアクション URL で定義します。場所がアクション (コンテキストメニュー、ツールバーアイテム、ダイアログ内のアクションなど) で、アクションタイプが GET または POST の場合、アクション URL は REST 終点を指定するために使用されます。場所がアクションで、新しいウィンドウで開くアクションの場合、アクション URL は新しいウィンドウで開く URL です。

     • このフィールドで使用できるパラメータのリストについては、開発者ドキュメントのアクション URL パラメータを参照してください。

   • アクションタイプ: UI を埋め込まない場所に適用されます。サポートされているアクションタイプは次のとおりです。

     • GET - アクション URL を使用して GET API を呼び出します。パラメータの置換はアクション URL で行われます。

     • POST - アクション URL とアクションボディを POST ボディとして使用して POST API を呼び出します。パラメータの置換は、アクション URL とアクションボディの両方で行われます。

     • 新しいウィンドウで開く - アクション URL が新しいブラウザウィンドウで開きます。パラメータの置換はアクション URL で行われます。

   • アクションボディ: POST アクションタイプにのみ適用されます。アクションボディは POST API の呼び出しに渡され、有効な JSON 形式である必要があります。

   • 応答を表示: これは、アクションタイプが GET または POST の場合にのみ適用されます。選択すると、UI は応答を待ち、UI のダイアログに応答を表示します。応答は有効な JSON 形式である必要があります。

   • アイコン: アイコンは、拡張子が存在する場所に表示されます。これには、情報パネルのアイコン、コンテキストメニューのアクション、ツールバーボタン、ダイアログのアクションボタン、またはその他のサポートされている場所が含まれます。

5. [OK] をクリックします。

Onshape アプリケーションの作成と管理の詳細については、Onshape の開発者向けドキュメントを参照してください。実例については、Hello World のチュートリアルをご覧ください。

管理者は、Onshape App Store にアプリケーションを提出する前に、内部ユーザーをアプリに追加してテストできます。アプリに追加されたユーザーは、App Store で購読せずに、関連するアプリ拡張機能が Onshape UI に自動的に表示されます。

1. アプリが登録されたら、左ペインの [アプリケーション] をクリックします。

2. リストからアプリケーションを選択します。

   

3. まず、[ユーザーまたはチームを追加] フィールドにユーザー、チーム、またはエイリアスの名前またはメールアドレスを入力し、リストから結果を選択します。アプリを作成した管理者は、自動的にユーザーリストに表示されます。名前やメールアドレスの追加を続けます。

   

4. [追加] ボタンをクリックします。

ライトユーザーはアプリケーションに追加できません。

ユーザー、エイリアス、またはチームをアプリから削除するには、[削除] 列の X アイコンをクリックします。

1. 開発者の設定で、[OAuth アプリケーション] をクリックします。
2. 転送するアプリの名前をクリックします。
3. Click the Transfer ownership button on the Details tab. The Transfer ownership dialog opens.

   

4. アプリの引き継ぎ先として個人、Company、または Enterprise のオプションを選択します。
5. 個人に引き継ぐには、検索フィールドに新しい所有者の名前またはメールアドレスを入力します。所有権を Company または Enterprise に引き継ぐには、ドロップダウンからオプションを選択します。
6. [所有権の引き継ぎ] をクリックします。アプリケーションが OAuth アプリのリストから削除されます。
   • アプリを個人のアカウントに引き継いだ場合は、その個人に通知メールが届き、Onshape 開発者ポータルにアプリが表示されます。
   • アプリを Company/Classroom/Enterprise のユーザーに引き継いだ場合は、管理者全員に通知メールが届き、それぞれの開発者の設定にアプリが表示されます。

それ以降の API コールの使用量と請求は、新しい所有者に帰属します。詳細は、API の制限を参照してください。

1. Click Developer in the left pane of your company settings, click OAuth applications, then select the app to deprecate.

2. On the Details tab, click the Delete permanently button.
   

3. Click Delete again to confirm in the dialog.

OAuth アプリケーションに新しいストアエントリを作成するには、次の操作を実行します。

1. Click OAuth applications on the Developer page, then select your application.

2. Click the Create store entry button on the app's Details tab.

   

3. フォームの次の項目を記入します。

   • 名前 - 登録時に入力したアプリ名から自動的に設定されます。

   • 概要 - 登録時に入力した概要から自動的に設定されます。

   • タイプ - アプリケーションのタイプ: 統合クラウドアプリ、接続されたクラウドアプリ、接続されたデスクトップアプリ。これは、OAuth アプリケーションの登録時に選択したタイプと一致する必要があります。

   • カテゴリー - アプリに適したカテゴリーを選択します。

   • チームの可視性 - プライベート App Store のエントリを内部ユーザー以外に表示しない (既定)、すべての内部ユーザーに表示する、または特定のチームに表示することを選択します。

   • 説明 - ユーザー向けのアプリケーションの説明。制限付き書式設定が使用できます。

   • サポート URL - アプリのユーザーがヘルプを必要とした場合に送る URL またはメール。これは定期的に監視する必要があります。

   • サポートメール - アプリのサブスクリプション通知を受け取るメール。これは定期的に監視する必要があります。

   • ベンダー - あなたの Company 名。

   • バージョン - このアプリケーション現在のバージョン。

   • 画像 - オプションで、概要、ヒーロー、その他の画像をアップロードします。

4. [作成] をクリックします。

アプリケーションは Onshape App Store にプライベートとして表示され、あなたとチームの可視性設定で指定された内部チームだけに表示されます。アプリを公開するには、次のローンチのチェックリストを参照してください。

To return to this screen, click the Store entry tab for the application:

1. Click OAuth applications on the Developer page, then select your application.
2. Click the Store entry tab.
3. Click Delete store entry on the Details tab.
   
4. [削除] をクリックして確定します。