Company/Classroom/Enterprise 設定 - 開発者

1. 開発者ページの OAuth アプリケーションのリンクをクリックすると、すべてのアプリのリストが表示されます。

   

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

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

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

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

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

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

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

     • この URL も SSL (https で始まる URL) を使用する必要があります。ただし、インストールされるデスクトップアプリケーションには http://localhost:<port> と urn:ietf:wg:oauth:2.0:oob という 2 つの例外があります。

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

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

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

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

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

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

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

   • 設定

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

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

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

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

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

6. アプリの OAuth アプリケーションエントリは、[詳細] タブがアクティブな状態で表示されます。[OAuth アプリケーション] タブでアプリ名を選択すると、この画面が表示されます。

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

• 詳細:

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

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

  • アプリケーションを削除する

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

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

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

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

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

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

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

1. 開発者ページで [OAuth アプリケーション] をクリックし、アプリケーションを選択します。

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. [詳細] タブの [所有権の引き継ぎ] ボタンをクリックし、所有権の引き継ぎダイアログを開きます。

   

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

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

1. Company 設定の左側のペインで [開発者] をクリックし、[OAuth アプリケーション] をクリックして、非推奨にするアプリを選択します。
2. [ステータス] ボタンをクリックすると、アプリケーションの現在のステータスと、サポートされているステータスの変更が表示されます。サポートされているステータスは次のとおりです。
   • アクティブ - アプリケーションは Onshape App Store で購入できます。
   • 非推奨 - アプリは App Store では利用できなくなりますが、現在のユーザーは引き続きアクセスできます。
   • ごみ箱 - アプリは OAuth アプリケーションページから削除され、ごみ箱タブに移動します。

     • ごみ箱からの削除は、すべての有料サブスクリプションの有効期限が切れた後にのみ許可されます。

     • すべての購入と権限が消去されます。

   • 削除済み - アプリケーションはごみ箱から完全に削除されます。これは元に戻せません。
     
3. 希望するステータス変更を選択します。
4. アプリの名前を入力し、もう一度クリックしてダイアログで確認します。

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

1. 開発者ページで [OAuthアプリケーション] をクリックし、アプリケーションを選択します。

2. アプリの [詳細] タブで [ストアエントリを作成] ボタンをクリックします。

   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

この画面に戻るには、アプリケーションの [ストアエントリ] タブをクリックし、アプリケーションを選択します。

1. 開発者ページで [ストアエントリ] をクリックし、アプリを選択します。
2. [ストアエントリを削除] をクリックします。
   
3. [削除] をクリックして確定します。