Apigee DevRel

<!-- Copyright 2024 Google LLC Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. -->

Common solutions and tools developed by Apigee.

References

This folder contains reference solutions across a variety of Apigee products. It is expected that these solutions are used as an illustration or extended further to fit a particular use case.

• Common Shared Flows - Reusable API Policies including Security, Traffic Management, Error Handling and CORS
• Custom Java Extensions in Apigee - A reference project that includes a Java Extension
• GCP Service Account Shared Flow - A shared flow to obtain access tokens for GCP service accounts
• CI/CD Pipeline - Reference implementation for a CI/CD Pipeline using the Apigee Deploy Maven Plugin and a choice of either Jenkins or Google Cloud Build
• CI/CD Pipeline for Shared Flows - Reference implementation for a CI/CD Pipeline for Sharedflows using the Apigee Deploy Maven Plugin
• Cloud Logging Shared Flow - Reference implementation for a shared flow to log to Google Cloud Logging
• Cloud Run - Reference implementation for using Apigee to expose a Cloud Run Service
• Data API - A reference implementation for using Apigee to facilitate the consumption of data from a data platform.
• Data Converters Shared Flow - A reference shared flow for doing common response data JSON conversions
• Product Recommendations - Smart API to Predict Customer Propensity to buy using Apigee, BigQuery ML and Cloud Spanner
• Proxy Template - An extensible templating tool to bootstrap API proxies containing Security, Traffic Management, Error Handling
• Writing JavaScript in Apigee - Demonstrate best practices in writing JavaScript code in Apigee context
• Southbound mTLS - Reference for using mTLS client authentication for securely connecting Apigee to backend services
• OIDC Mock - A simple OIDC mock identity provider implementation
• Identity Facade - Reference implementation for an Identity Facade proxy in front of an OIDC compliant identity provider
• OAuth Admin API - API proxy to enable the revocation of Apigee-issued access tokens by application or end user id.
• Dutch Healthcare Reference - An API reference to accelerate implementation of Dutch Healthcare standards.
• XML & JSON Threat Protection - A reference for protecting API proxies against XML and JSON threats
• Auth Schemes - Example implementations for various popular API auth schemes
• reCAPTCHA enterprise - A reference for API protection against bot leveraging reCAPTCHA enterprise
• Firestore Facade - Reference implementation for a long term caching/storage solution based on Cloud Firestore
• OpenAPI Mock - Reference implementation for creating a mock API proxy from an OpenAPI 3 specification

Tools

This folder contains ready-made utilities which simplify and assist the usage of Apigee products.

• Pipeline Runner - A tool to build and test groups of Apigee projects
• Pipeline Linter - A tool to lint groups of Apigee projects
• Apigee hybrid Quickstart GKE - A quickstart setup configuration for Apigee hybrid on GKE
• Decrypt Hybrid Assets - A rescue utility to decrypt proxies and shared flows
• Apigee X Trial Provisioning Reference - A reference provisioning script for Apigee X trial provisioning
• Apigee Sackmesser - A unified proxy deployment utility for Edge, hybrid and X
• Apigee OpenLegacy Kickstart - A kickstart script to integrate OpenLegacy, Apigee and Cloud Run
• OpenAPI to Apigee Mock Proxy - A utility to generate an Apigee Proxy bundle with mock responses from a spec
• Cloud Endpoints OpenAPI Importer - A utility to generate Apigee Proxies based on OAS with Cloud Endpoints OAS extensions
• Generate Shared Flows Dependency List - A tool to generate topologically sorted Shared Flow dependencies.
• Apigee Envoy Quickstart Toolkit - A tool to set up the sample deployments of Apigee Envoy.
• Apigee API Proxy Endpoint Unifier - A tool to unify/split proxy endpoints based on API basepath.
• Apigee Target Server Validator - A tool to validate all targets in Target Servers & Apigee API Proxy Bundles.
• gRPC to HTTP Gateway Generator - Generate gateways to expose gRPC services with HTTP API management.
• Apigee Proxy Bundle Modifier & Validator - A tool to do batch modifications of API proxies when migrating to newer Apigee variants.
• Apigee Edge to X Migration Accelerator - A tool built on node.js to accelerate Apigee Edge to X migration.
• Apigee Config Diff Tool - A tool to find and deploy only the changes in Apigee configurations.

Labs

This folder contains raw assets used to generate content to teach a particular technical or non-technical topic.

• Best Practices Hackathon (web) A 300 level lab to learn Apigee Best Practices
• BDD Proxy Development (web) A 200 level lab demonstrating behavior-driven API development by building, deploying and testing a mock API, generated from an Open API Specification.
• Identity facade with Okta (web) A 300 level lab that shows how to configure the Apigee Identity Facade with Okta IDP.
• Eventarc + API Hub integration - A lab for a workflow-based automation to deploy proxies using API hub and Eventarc

Contributing

See the contributing instructions to get started.

License

All solutions within this repository are provided under the Apache 2.0 license. Please see the LICENSE file for more detailed terms and conditions.

Disclaimer

This repository and its contents are not an official Google product.

Contact

Questions, issues and comments should be directed to apigee-devrel-owners@google.com.