2018-08-03 Meeting Notes

Date

Attendees

Goals

  • Updates on continuing development
  • Review, organize and add to work items

Discussion items

TimeItemWhoNotes
Welcome
  • Greetings and salutations

General Info
  • Vince Nievares
    • Will be on vacation  -  (Phillipines)
  • UC Path
    • August and September is going to have UC Path as the priority



Action Items From Previous MeetingSteven Maglio
  • Former user (Deleted) will add descriptions to Dining Cams and Housing Dates APIs (APIGEE-124)
  • Create future Meeting Note for following up on what people took away from the Pantheon training
  • Steven Maglio Create @apibot report commnds requirements. Add a use case where users can get usage; and usage by version number; and usage by version with appication breakdown; and high level report where someone can access it (push onto developer.ucsb.edu?)
    • Research - Are there any companies that Apigee logs are already being pushed to, which have better reporting already written. Do those companies allow for dashboards to be displayed in external apps (developer.ucsb.edu)?
  • Next meeting schedule 30 minutes to go through requirements gathering on API Versioning
  • Diana Antova - API Proposal - An api that could return who has left UCSB (UC Path/PPS) in the past X days (maybe Adam can do this)
    • who has changed departments



Portal - About Section

Vince Nievares

  • About Section (APIGEE-107)
    • Vince Nievares is gonna look into moving the text into the main area of the page.
    • If he's unable to move it into the page, he'll move it into it's own page and add a link on the menu (maybe FAQ?)
      • Diana Antova will contact Denise about where the  correct place is to put an About Section



Portal - API Docs only Visible to Registered UsersIan Lessing (Unlicensed)
  • Permissions to only allow Logged In users to see some API Documentation (APIGEE-117)
    • Ian Lessing (Unlicensed) did get ahold of Denise, and she is used a different authentication module. Ian is thinking about installing the module Denise suggested and trying it out.
    • Steven Maglio will contact Denise and see if she can put it back so it's grouped. And ask if she can work with the css to make it easier to read and emphasis the APIs over the groupings.



Workflow - Publish a New API

Ian Lessing (Unlicensed)

  • Dev Portal Documentation - How To Use Workflow (APIGEE-119)



@apibot - Powershell Conversion & HostingKevin Wu
  • Working on Kevin's Computer (node 8.9.X) (APIGEE-105 & APIGEE-101)
  • Apigee Authorization Module (AuthApigee)
  • Replacement Functionality Progress Update
    • apps 
      • apps (no|approved|revoked|pending|all)
      • apps (approve|revoke) email developerApp
      • apps (approve|revoke) email developerApp apiProduct
      • apps search
      • apps users?
    • devs
      • devs created <days=1>
    • targetserver
    • companies
      • Kevin Wu will implement?
      • Need to build requirements
      • Need to build use cases
      • Need reporting that will display in developer.ucsb.edu
      • Need annual clean up times
  • Get operational on GCP
    • Kevin Wu will determine if this is the platform we want to use and will figure out the annual costs if we. We will use this to put together a flex card request.



Access Request WorkflowDiana Antova



Portal - Apigee Companies Add-OnIan Lessing (Unlicensed)Steven Maglio



New API Request Workflow in PortalDiana Antova
  • Brought up by Ann Crawford with the following questions:
    • How do we request a use case for an API
    • What is the work flow? Possible status are : received, rejected (with reason ie duplicate), closed ( with deploy date), in test,  in code
    • How do we search what's in the works?
    • Who will mange requests?
Specific use case from Ann Crawford:
Here is the API use case that I sent to housing for the photos.
Our use case is to get all new or changed photos for Type graduate or undergraduate with the perm (university ID)

New photos are perms we don't have a photo in the student health database.
Changed photos are those where the saved photo hash <> current photo hash for a given perm.   Currently the sproc returns a hash of the photo so we can compare and save, along with a perm (university ID), Type, first name, last name.  We don't use the first name or last name but it is good for testing.
11:00 AM - 11:30 AMAPI VersioningSteven Maglio



API Keys in Public CodeFormer user (Deleted)
  • Need to use API Key in public code (Javascript). It can get stolen so we need extra lockdown. That should be referrer domain name set upin API App. Or some other complex auth system, but it always needs to include the domain. (This should be Security Workgroup's job )

Pantheon Training Follow-Up

 

Steven Maglio
  •  1 - 5 pm - Pantheon Overview, Terminus Overview and Demo, Performance & Going Live
  •  1 - 5 pm - Custom Upstream Development
  • What did people learn?

DocumentationFormer user (Deleted)
  • Docs on Portal site need some updates and fine tuning. I can work on those and edit them with a "technical writing" style. 
  • Data Access Requests should be done thru docusign, and we should standardize it for all UCSB depts.

Action items

  • Diana Antova and Steven Maglio will start this process with Registrar's Office to use the Publish an API Workflow for the APIs that are already in place.