Objective
To describe all areas required to support the API Management platform Apigee at UCSB, and the responsible people for each area. The platform consists of two main tools - the developer portal, and the gateway, both described below.
Developer Portal (https://developer.ucsb.edu/): used for API discovery and access/publishing requests. API users sign up for the developer portal, create an App, and request access to APIs for their app. An API key is given to them to be able to access the APIs. The API team has developed access request forms to manage the API publishing and API access requests and record the decisions. The API team has developed standards and guidelines for API use by employees, and by students.
Gateway (https://login.apigee.com/login): used for API publishing, execution, and statistics. Gateway accounts require Apigee license. Users publish APIs, grant API access to Apps, have access to Apigee reports in the gateway to troubleshoot errors and to view API usage statistics.
Team email address: support@developer.ucsb.edu. All team members receive all communications to this email.
Team members: listed on bottom of page
Apigee Responsibility Matrix
Area | Duties | Primary Responsible Person | Other Responsible People | Documentation Links |
---|---|---|---|---|
Developer Portal Account Approval |
| Diana Antova / Steven Maglio | API team has access to approve/deny accounts | |
API Access Requests |
| Diana Antova | Steven Maglio | https://developer.ucsb.edu/docs/applications/application-approval-request https://developer.ucsb.edu/docs/gateway-admin/processing-api-access-request |
API Publishing Requests |
| Steven Maglio | Kevin Wu / Gary Scott | https://developer.ucsb.edu/api-publishing-request |
Application Development Support |
| Steven Maglio | Kevin Wu / Gary Scott | https://developer.ucsb.edu/docs/accounts/ldap-accounts https://developer.ucsb.edu/getting-started https://developer.ucsb.edu/creating-your-first-app https://developer.ucsb.edu/trying-out-apis https://developer.ucsb.edu/docs/applications/testing-applications https://developer.ucsb.edu/docs/security/overview https://developer.ucsb.edu/docs/security/application-security-review |
Student Development Support |
| Steven Maglio | Diana Antova / Seth Northrop | https://developer.ucsb.edu/docs/applications/student-developed-applications |
Business API Access Approval |
| Diana Antova | Steven Maglio | https://developer.ucsb.edu/business-api-access-request-approver Each API Publishing Request form contains the name(s) of people that are allowed to approve the publishing of an API and access requests. |
New API Development |
| Steven Maglio | Diana Antova | |
Developer Portal Development |
| Ian Lessing (Unlicensed) | Diana Antova / Steven Maglio / Vince Nievares | |
Developer Portal Maintenance |
| Ian Lessing (Unlicensed) | Steven Maglio / Vince Nievares | This is a manual process |
API Documentation Support |
| Diana Antova | Review the API documentation to make sure all is correct. | |
Slack commands support |
| Kevin Wu | Steven Maglio | https://developer.ucsb.edu/docs/slack-chatbot |
API Monitoring |
| Steven Maglio | Reinard Dolleschel | https://developer.ucsb.edu/docs/gateway-admin/add-upcheck |
Splunk integration |
| christian.montecino (Unlicensed) | Steven Maglio / Diana Antova | https://developer.ucsb.edu/docs/gateway-admin/edit-an-api-proxy |
Developer engagement and account cleanup |
| Steven Maglio | Usage data is extracted on a weekly basis and recorded in a database along with user accounts, with the purpose to identify accounts that are not using APIs and disable access. | |
API Support SIS&T |
| Seth Northrop / Aurelian Marian | Steven Maglio | Each API has a corresponding API Publishing request, where the developer(s) and approver(s) are listed. |
API Support ARIT |
| Gary Scott | Masha Aksenova | Each API has a corresponding API Publishing request, where the developer(s) and approver(s) are listed. |
API Support ETS |
| Kevin Wu | christian.montecino (Unlicensed) | Each API has a corresponding API Publishing request, where the developer(s) and approver(s) are listed. |
Project team management |
| Diana Antova | Steven Maglio | The team meets 3 times a month for 1.5 hours each meeting. Additional time is spent on project work outside of meetings as necessary. |
API Team Members:
Diana Antova - SIS&T
Steven Maglio - SIS&T
Ian Lessing (Unlicensed) - Library
Kevin Wu - ETS
christian.montecino (Unlicensed) - ETS
Vince Nievares - Academic Affairs IT
Reinard Dolleschel - Biological Sciences Administration IT
Gary Scott - ARIT (Former team member, has Apigee license)
Seth Northrop - SIS&T (Has Apigee license, not part of the team)