Bienvenue dans Apigee Edge for Private Cloud

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X.
info

Edge for Private Cloud est une installation sur site d'Apigee Edge. Vous contrôlez l'environnement matériel et êtes responsable de l'installation, de la mise à niveau, de la maintenance et des processus administratifs du produit.

Nouveautés

Consultez les notes de version d'Apigee.

Accéder à la communauté Apigee

La communauté Apigee est une ressource gratuite grâce auquel vous pouvez contacter Apigee, ainsi que d'autres clients Apigee, pour leur poser des questions, demander des conseils et rechercher de l'aide sur d'autres problèmes. Avant de publier dans la communauté, veillez à rechercher d'abord les posts existants pour voir si une question a déjà été traitée.

Présentation de l'architecture

Avant d'installer Apigee Edge pour le cloud privé, vous devez vous familiariser avec l'organisation globale des modules Edge et des composants logiciels.

Apigee Edge pour le cloud privé se compose des modules suivants:

  • Passerelle Apigee Edge (également appelée "Services API")
  • Apigee Edge Analytics
  • Services de monétisation Apigee Edge (également appelés "Monétisation des services pour les développeurs")

L'image suivante montre comment les différents modules interagissent dans Apigee:

Les modules Edge connectent différents services et équipes au sein d'une organisation. Par exemple, Edge Analytics connecte un utilisateur professionnel aux services backend et à l'équipe API. Edge Monetization connecte un développeur à l'équipe API. L'application est connectée par Edge Gateway et Edge App Services aux services backend et à l'équipe API. Tous ces services et équipes sont interconnectés d'une manière ou d'une autre.

Pour en savoir plus sur la création d'un portail des développeurs, consultez la section Créer votre portail avec Drupal 9.

Passerelle Apigee Edge

Edge Gateway est le module principal d'Apigee Edge et l'outil principal de gestion de vos API. L'interface utilisateur de la passerelle fournit des outils permettant d'ajouter et de configurer vos API, de configurer des bundles de ressources et de gérer les développeurs et les applications. La passerelle décharge de nombreux problèmes de gestion courants de votre API backend. Lorsque vous ajoutez une API, vous pouvez appliquer des règles pour la sécurité, la limitation du débit, la médiation, la mise en cache et d'autres contrôles. Vous pouvez également personnaliser le comportement de votre API en appliquant des scripts personnalisés, en appelant des API tierces, etc.

Composants logiciels

Le Edge Gateway est composé des principaux composants suivants:

  • Serveur de gestion Edge
  • Apache ZooKeeper
  • Apache Cassandra
  • Edge Router
  • Processeur de messages Edge
  • OpenLDAP
  • Interface utilisateur Edge (anciennement appelée Nouvelle expérience Edge) et interface utilisateur classique

Le Edge Gateway est conçu pour que ces éléments puissent tous être installés sur un seul hôte ou répartis entre plusieurs hôtes.

Apigee Edge Analytics

Edge Analytics propose des données analytiques d'API puissantes pour identifier les tendances d'utilisation à long terme. Vous pouvez segmenter votre audience en fonction des meilleurs développeurs et applications, comprendre l'utilisation par méthode API pour savoir où investir, et créer des rapports personnalisés sur les informations au niveau de l'entreprise.

Lorsque les données transitent par Apigee Edge, plusieurs types d'informations par défaut sont collectés, y compris l'URL, l'adresse IP, l'ID utilisateur pour les informations d'appel d'API, la latence et les données d'erreur. Vous pouvez utiliser des règles pour ajouter d'autres informations, telles que des en-têtes, des paramètres de requête et des parties d'une requête ou d'une réponse extraite de XML ou de JSON.

Toutes les données sont transmises à Edge Analytics, où elles sont gérées par le serveur d'analyse en arrière-plan. Les outils d'agrégation de données peuvent être utilisés pour compiler différents rapports intégrés ou personnalisés.

Composants logiciels

Edge Analytics comprend les éléments suivants:

  • Qpid, qui se compose des éléments suivants :
    • Système de messagerie Apache Qpid
    • Service Apigee Qpid Server : service Java d'Apigee utilisé pour gérer Apache Qpid
  • Postgres, qui comprend les éléments suivants :
    • Base de données PostgreSQL
    • Service Apigee Postgres Server : service Java d'Apigee utilisé pour gérer la base de données PostgreSQL

Services de monétisation Apigee Edge

Les services de monétisation Edge sont une nouvelle extension puissante d'Apigee Edge pour le cloud privé. En tant que fournisseur d'API, vous avez besoin d'une solution flexible et facile à utiliser pour monétiser vos API, et ainsi générer des revenus pour l'utilisation de ces API. Les services de monétisation répondent à ces exigences. Avec les services de monétisation, vous pouvez créer différents plans tarifaires qui facturent aux développeurs l'utilisation de vos API regroupées dans des packages. La solution offre un haut niveau de flexibilité: vous pouvez créer des forfaits prépayés, des forfaits postpayés, des forfaits à tarif fixe, des forfaits à tarif variable, des forfaits freemium, des forfaits adaptés à des développeurs spécifiques, des forfaits couvrant des groupes de développeurs, etc.

De plus, les services de monétisation incluent des fonctionnalités de création de rapports et de facturation. Par exemple, en tant que fournisseur d'API, vous pouvez obtenir des rapports récapitulatifs ou détaillés sur le trafic vers vos packages d'API pour lesquels les développeurs ont souscrit un plan tarifaire. Vous pouvez également modifier ces enregistrements si nécessaire. Vous pouvez également créer des documents de facturation (y compris les taxes applicables) pour l'utilisation de vos packages d'API et les publier auprès des développeurs.

Vous pouvez également définir des limites pour contrôler et surveiller les performances de vos packages d'API et vous permettre de réagir en conséquence. Vous pouvez également configurer des notifications automatiques lorsque ces limites sont approchées ou atteintes.

Fonctionnalités des services de monétisation

Voici les principales caractéristiques des services de monétisation Edge:

  • Intégration totale à la plate-forme d'API : interaction en temps réel
  • Prise en charge de tous les modèles commerciaux prêts à l'emploi, des forfaits simples aux modèles de facturation/partage des revenus les plus complexes (création et modification faciles des forfaits)
  • Tarifiez les transactions en fonction du volume ou des attributs personnalisés dans chaque transaction. La transaction peut être composée d'API de la passerelle ET d'autres systèmes (externes à Apigee Edge).
  • Des outils automatisés tels que des limites et des notifications pour surveiller les performances et gérer le processus
  • Workflow et commandes intégrés pour les développeurs/partenaires afin de gérer les achats via la facturation/le paiement
  • Entièrement en libre-service pour les utilisateurs professionnels et les développeurs/partenaires, ce qui évite toute intervention technique coûteuse
  • Intégration à n'importe quel système de vente, de comptabilité et d'ERP backend

Couches d'une installation Edge, avec l'UI de gestion et le portail du développeur servant de couche d'interface et tous les autres composants Edge fournissant des services.

Composants logiciels

Les services de monétisation Edge reposent sur les composants principaux suivants:

  • Serveur de gestion Edge
  • Processeur de messages Edge

Pour en savoir plus sur les premiers pas avec les services de monétisation à l'aide de l'interface utilisateur Edge, consultez la page Premiers pas avec la monétisation.

Déploiement sur site

Une installation sur site du cœur d'Apigee Edge pour Private Cloud (passerelle et analyse) fournit l'infrastructure requise pour exécuter le trafic des API au nom des clients du client sur site.

Les vidéos suivantes vous présentent les modèles de déploiement d'Apigee Edge pour le cloud privé:

S26E01: Présentation du modèle de déploiement

S26E04: Architecture de déploiement

Les composants fournis par l'installation sur site d'Edge Gateway incluent, sans s'y limiter, les éléments suivants :

  • Un routeur gère tout le trafic API entrant à partir d'un équilibreur de charge, détermine l'organisation et les environnements du proxy d'API qui gère la requête, équilibre les requêtes entre les processeurs de messages disponibles, puis distribue la requête. Le routeur met fin à la requête HTTP, gère le trafic TLS/SSL et utilise le nom d'hôte virtuel, le port et l'URI pour diriger les requêtes vers le processeur de messages approprié.
  • Un processeur de messages traite les requêtes API. Le processeur de messages évalue les requêtes entrantes, exécute toutes les règles Apigee et appelle les systèmes backend et les autres systèmes pour récupérer les données. Une fois ces réponses reçues, le processeur de messages les met en forme et les renvoie au client.
  • Apache Cassandra est le dépôt de données d'exécution qui stocke les configurations d'application, les compteurs de quotas distribués, les clés API et les jetons OAuth pour les applications exécutées sur la passerelle.
  • Apache ZooKeeper contient des données de configuration sur l'emplacement et la configuration des différents composants Apigee, et informe les différents serveurs des modifications de configuration.
  • OpenLDAP (LDAP) pour gérer les utilisateurs et les rôles du système et de l'organisation.
  • Un serveur de gestion pour rassembler ces éléments. Le serveur de gestion est le point de terminaison des requêtes de l'API Edge Management. Il interagit également avec l'interface utilisateur Edge.
  • Une interface utilisateur fournit des outils basés sur le navigateur qui vous permettent d'effectuer la plupart des tâches nécessaires pour créer, configurer et gérer des proxys d'API, des produits d'API, des applications et des utilisateurs.

Voici les composants fournis par l'installation sur site d'Edge Analytics:

  • Un serveur Qpid gère le système de mise en file d'attente des données d'analyse.
  • Un Postgres Server gère la base de données d'analyse PostgreSQL.

Le schéma suivant illustre les interactions entre les composants Apigee Edge:

Le serveur de gestion, qui est associé à la plupart des autres composants, est la figure centrale de l'interaction des composants Edge. Certains composants, tels que le routeur et le processeur de messages, interagissent directement les uns avec les autres en plus d'interagir avec le serveur de gestion. Des composants tels que Qpid et Postgres comportent des composants de données secondaires qui ne sont pas directement connectés au serveur de gestion.