LAB-API-190 — API Contract Reconnaissance Capstone
Brief
Northstar Training Services is consolidating several API estates. The organisation has SOAP messages and XSDs, an OpenAPI description, a GraphQL schema, a WSDL contract and a legacy WADL file. Your task is to produce one evidence-led reconnaissance pack before any active testing begins.
Part 1 — Format classification
Complete:
| Format | Message, schema or service description? | Primary syntax | Main discovery value | Important limitation |
|---|---|---|---|---|
| SOAP | ||||
| OpenAPI | ||||
| GraphQL | ||||
| WSDL | ||||
| WADL |
Part 2 — Unified surface register
Create a single register containing every operation or resource from the supplied fixtures. Required fields:
- source document and exact location;
- operation/resource name;
- protocol and endpoint information;
- input schema and constraints;
- response/fault model;
- documented authentication;
- authorisation hypothesis;
- personal or sensitive data;
- resource-consumption concerns;
- test priority.
Part 3 — Trust-boundary diagram
Draw a diagram showing:
- external clients;
- API gateway or edge controls;
- SOAP and HTTP endpoints;
- GraphQL execution layer;
- identity provider;
- domain services and data stores;
- logging, monitoring and support access.
Mark where the contract gives evidence and where runtime verification is still required.
Part 4 — Prioritised test charter
Produce 15 tests across at least these categories:
- authentication;
- object-level authorisation;
- function/field-level authorisation;
- schema and boundary validation;
- mass assignment or over-posting;
- sensitive-data exposure;
- parser and content-type handling;
- query depth, pagination or resource consumption;
- error and fault leakage;
- versioning, deprecated operations and shadow endpoints.
Each test must include:
- target operation;
- precondition and authorised identity;
- hypothesis;
- bounded test variation;
- expected secure behaviour;
- evidence to capture;
- cleanup or rollback requirement;
- retest criterion.
Part 5 — Executive summary
Write no more than 400 words covering:
- what the contracts reveal;
- the three highest-risk unknowns;
- prerequisites for active testing;
- controls that should be validated first;
- how the test plan minimises production risk.
Scoring rubric
| Area | Weight | Evidence of mastery |
|---|---|---|
| Format interpretation | 20% | Correctly separates messages, schemas, abstract interfaces and concrete endpoints |
| Surface completeness | 20% | Traceable operation/resource inventory with source references |
| Security reasoning | 25% | Test hypotheses distinguish authentication, authorisation, validation and resource controls |
| Safety and governance | 15% | Clear scope, identities, rate limits, rollback and evidence handling |
| Technical communication | 20% | Prioritised, concise and reproducible deliverables |
Completion standard
A passing submission is technically correct, traceable to the supplied artefacts and executable by another authorised tester without relying on undocumented assumptions.