mablにPostmanコレクションをインポートすると、mablは作成されたテストにPostmanの認証設定を再現します。この記事では、mablがPostmanコレクションからmablのAPIテストに認証設定をインポートする方法について説明します。
Postmanとmablにおける認可レベルを理解する
mablのAPI認証はPostmanと同様に動作します。上位レベルで設定した認証は個々のリクエストに引き継がれますが、下位レベルで認証を明示的に設定すると、上位レベルの認証設定を上書きします。
Postmanの認証とmablの認証の主な違いは、テストの整理方法に関係しています。
Postman認証タイプ
認証の種類 | 説明 |
コレクションレベル認証 | コレクション内のすべてのリクエストに適用されますが、子フォルダーやリクエストの認証設定で上書きされている場合はその限りではありません。 |
フォルダレベル認証 | 子フォルダーやリクエストの認証設定で上書きされていない限り、下位のフォルダーやリクエストにも適用されます。 |
リクエストレベルの認証 | 個々のリクエストに適用されます |
mabl認証タイプ
認証の種類 | 説明 |
テストレベルの認証 | APIテスト内のすべてのリクエストに適用されますが、フローまたはリクエストレベルで認証が設定されている場合はそちらが優先されます。 |
フローレベル認証 | APIフロー内のすべてのリクエストに適用されますが、リクエストレベルで認証が設定されている場合はそちらが優先されます。 |
リクエストレベルの認証 | 個々のリクエストに適用されます |
mablへの認証設定のインポート
mablは、Postmanコレクションを個別のテストとしてインポートするか、単一のテストとしてインポートするかによって、認証設定のインポート方法が異なります。
個別のテストとしてインポートする
フォルダーを個別のテストとしてインポートする場合、次のルールが適用されます。
- フォルダーが固有の認証設定を持つ場合、その認証設定が、作成されたAPIテストに対するテストレベルの認証設定になります。
- フォルダーが親フォルダーまたはコレクションから認証設定を継承した場合、継承した認証設定が、作成されたAPIテストに対するテストレベルの認証設定になります。
リクエストレベルの認証を持つリクエストは、作成されたAPIテストで、同じリクエストレベル認証をそのまま使用します。
単一のテストとしてインポートする
Postmanコレクション全体を単一のテストとしてインポートする場合、次のルールが適用されます。
- Postmanコレクションの認証設定は、作成されたAPIテストに対するテストレベルの認証設定になります。
- コレクションとは異なる認証設定をフォルダーが持つ場合、フォルダーの認証設定を継承したPostmanリクエストは、対応する認証フィールドを持つmablリクエストとしてインポートされます。
リクエストレベルの認証を持つリクエストは、作成されたテストで、同じリクエストレベル認証をそのまま使用します。
サポートされている認証タイプ
現在、mablはAPIテストにおいて、APIキー、Basic認証、ベアラートークン、OAuth 1.0、OAuth 2.0の認証タイプに対応しています。Postmanコレクションにこれら以外の認証タイプが含まれている場合、それらは作成されるmablのAPIテストにはインポートされません。
他の認証タイプのサポートが必要な場合は、mabl Product Portalでお問い合わせください。