Open Access

Secure Developer Portal Design for Enterprise API Programmes: Onboarding and Credential Issuance, Access Approval Workflow, and Least-Privilege Key Management

4 Independent Researcher,USA

Abstract

An enterprise developer portal is usually described as the place where interface documentation is published. It is also where an organisation decides who may hold a credential for its application programming interfaces (APIs), which API products that credential reaches, and what record of the decision is kept. This paper presents a design for that function in enterprise API programmes, organised around three parts: onboarding and first credential issuance, the access approval workflow, and least-privilege management of API keys and client secrets. The design draws on developer portals implemented from 2018 onwards for multiple enterprise clients and rests on five commitments. A credential is generated only after a subscription has been approved. Credentials are bound to individual applications, so that each can be rotated or revoked without affecting any other. The boundary between self-service and approval follows security policy, data sensitivity, business ownership and risk. The approval workflow records its own evidence. Least privilege is checked before issuance and again at intervals, a commitment that took its present form after portal validation found an application holding broader API product access than it required because of an incorrect subscription configuration; no security incident occurred. Validation confirmed that onboarding, approval, issuance, rotation and revocation worked as the enterprise security requirements specified, and that credential lifecycle events were recorded and traceable where the gateway supported it. Operational quantities such as onboarding time, active credentials, rotation compliance, revocations and incidents were not collected, so the paper is a design and practice contribution, and it closes with an agenda for the measurements an evaluation would need.

Keywords

References

B. De, "API developer portal," in API Management. Berkeley, CA, USA: Apress, 2023, pp. 287-300, doi: 10.1007/979-8-8688-0054-2_11.
D. Hardt, Ed., "The OAuth 2.0 authorization framework," RFC Editor, RFC 6749, Oct. 2012, doi: 10.17487/RFC6749.
T. Lodderstedt, J. Bradley, A. Labunets, and D. Fett, "Best current practice for OAuth 2.0 security," RFC Editor, RFC 9700, Jan. 2025, doi: 10.17487/RFC9700.
D. Fett, R. KΓΌsters, and G. Schmitz, "A comprehensive formal security analysis of OAuth 2.0," in Proc. 2016 ACM SIGSAC Conf. Computer and Communications Security, 2016, pp. 1204-1215, doi: 10.1145/2976749.2978385.
M. Meli, M. R. McNiece, and B. Reaves, "How bad can it git? Characterizing secret leakage in public GitHub repositories," in Proc. Network and Distributed System Security Symp. (NDSS), 2019, doi: 10.14722/ndss.2019.23418.
M. Overeem, M. Mathijssen, and S. Jansen, "API-m-FAMM: A focus area maturity model for API management," Information and Software Technology, vol. 147, Art. no. 106890, Jul. 2022, doi: 10.1016/j.infsof.2022.106890.
A. Ghazawneh and O. Henfridsson, "Balancing platform control and external contribution in third-party development: The boundary resources model," Information Systems Journal, vol. 23, no. 2, pp. 173-192, Mar. 2013, doi: 10.1111/j.1365-2575.2012.00406.x.
M. Greiler, M.-A. Storey, and A. Noda, "An actionable framework for understanding and improving developer experience," IEEE Transactions on Software Engineering, vol. 49, no. 4, pp. 1411-1425, Apr. 2023, doi: 10.1109/TSE.2022.3175660.
J. H. Saltzer and M. D. Schroeder, "The protection of information in computer systems," Proceedings of the IEEE, vol. 63, no. 9, pp. 1278-1308, 1975, doi: 10.1109/PROC.1975.9939.
R. S. Sandhu, E. J. Coyne, H. L. Feinstein, and C. E. Youman, "Role-based access control models," Computer, vol. 29, no. 2, pp. 38-47, 1996, doi: 10.1109/2.485845.
R. A. Botha and J. H. P. Eloff, "Separation of duties for access control enforcement in workflow environments," IBM Systems Journal, vol. 40, no. 3, pp. 666-682, 2001, doi: 10.1147/sj.403.0666.
S. Rose, O. Borchert, S. Mitchell, and S. Connelly, "Zero trust architecture," National Institute of Standards and Technology, NIST Special Publication 800-207, Aug. 2020, doi: 10.6028/NIST.SP.800-207.
D. Temoshok, D. Proud-Madruga, Y.-Y. Choong, R. Galluzzo, S. Gupta, C. LaSalle, N. Lefkovitz, and A. Regenscheid, "Digital identity guidelines," National Institute of Standards and Technology, NIST Special Publication 800-63-4, Aug. 2025, doi: 10.6028/NIST.SP.800-63-4.
E. Barker, "Recommendation for key management: Part 1, general," National Institute of Standards and Technology, NIST Special Publication 800-57 Part 1 Revision 5, May 2020, doi: 10.6028/NIST.SP.800-57pt1r5.
S. K. Basak, L. Neil, B. Reaves, and L. Williams, "What are the practices for secret management in software artifacts?" in Proc. 2022 IEEE Secure Development Conf. (SecDev), 2022, pp. 69-76, doi: 10.1109/SecDev53368.2022.00026.
A. P. Felt, E. Chin, S. Hanna, D. Song, and D. Wagner, "Android permissions demystified," in Proc. 18th ACM Conf. Computer and Communications Security, 2011, pp. 627-638, doi: 10.1145/2046707.2046779.
M. W. Sanders and C. Yue, "Mining least privilege attribute based access control policies," in Proc. 35th Annual Computer Security Applications Conf., 2019, pp. 404-416, doi: 10.1145/3359789.3359805.
M. Hummer, M. Kunz, M. Netter, L. Fuchs, and G. Pernul, "Adaptive identity and access management: Contextual data based policies," EURASIP Journal on Information Security, vol. 2016, no. 1, Art. no. 19, Dec. 2016, doi: 10.1186/s13635-016-0043-2.
Joint Task Force Interagency Working Group, "Security and privacy controls for information systems and organizations," National Institute of Standards and Technology, NIST Special Publication 800-53 Revision 5, Sep. 2020, doi: 10.6028/NIST.SP.800-53r5.
OWASP API Security Project, "OWASP top 10 API security risks, 2023." [Online]. Available: https://api-security.owasp.org/editions/2023/en/0x11-t10/ (accessed Oct. 15, 2026).

Most read articles by the same author(s)

1 2 3 4 5 6 7 8 > >>