Как зарегистрировать разработчиков приложений

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация

Зарегистрируйте разработчиков приложений и управляйте ими, следуя инструкциям в приведенных ниже разделах. (Регистрация приложения – это отдельный процесс, описанный в статье Как зарегистрировать приложения и управлять ключами API.)

Введение

Преимущества Edge зависят от того, кто вызывает ваши API. Например, безопасность API, управление трафиком и значительная часть аналитических данных зависят от того, кто вызывает API. Как Edge узнает, кто вызывает ваши API? Считывая уникальную информацию в каждом вызове API, например идентификатор пользователя, ключ API или токен OAuth. Эта уникальная информация блокирует или разблокирует функции, встроенные в прокси API, предоставляя вам полный контроль над доступом к API и его поведением.

Поэтому разработчикам приложений необходимо регистрироваться, чтобы использовать ваши API. После этого разработчики регистрируют свои приложения, выбирают нужные API и получают уникальные учетные данные API (ключи и секреты потребителя), необходимые для доступа к вашим API.

Как зарегистрировать разработчика приложений

Зарегистрируйте разработчиков приложений одним из следующих способов:

• Если у вас платный аккаунт Edge, разработчики могут самостоятельно зарегистрироваться через портал для разработчиков. Подробнее о том, как это сделать, рассказывается в одном из следующих разделов в зависимости от типа портала для разработчиков:
  • Встроенный портал: создайте аккаунт разработчика на встроенном портале.
  • Drupal 10: как зарегистрировать аккаунт разработчика приложений
  • Drupal 7: добавление аккаунтов пользователей и управление ими
• Администраторы могут регистрировать разработчиков приложений с помощью API.
• Как администратор портала для разработчиков, вы можете управлять разработчиками непосредственно на портале. Подробнее об этом рассказывается в следующих разделах:
  • Встроенный портал: Управление аккаунтами разработчиков.
  • Drupal 10: Как разработчики приложений взаимодействуют с модулем Apigee Edge
  • Drupal 7: добавление аккаунтов пользователей и управление ими
• Администратор организации может управлять разработчиками с помощью интерфейса или API Edge, как описано в следующих разделах.

Рекомендации по управлению аккаунтами разработчиков на порталах для разработчиков

Apigee рекомендует управлять аккаунтами разработчиков непосредственно на портале для разработчиков.

Если вы используете интегрированный портал, это единственный способ обеспечить синхронизацию аккаунтов разработчиков на интегрированном портале и в Edge.

Если вы используете портал для разработчиков на основе Drupal, управление аккаунтами разработчиков непосредственно на портале дает следующие преимущества:

• Когда вы добавляете разработчика через интерфейс администратора на портале, вы можете задать пароль разработчика для портала и активировать автоматическую отправку электронного письма разработчику.

  При добавлении или изменении разработчика с помощью Edge ему не отправляется электронное письмо, и вы не можете задать пароль для разработчика на портале. Поэтому разработчику необходимо сбросить пароль на портале, прежде чем он сможет войти на него.

• Все изменения, внесенные в аккаунт разработчика на портале, автоматически отправляются в Edge.

Если вы решите управлять аккаунтами разработчиков на основе Drupal с помощью Edge, вам нужно будет синхронизировать разработчиков приложений между порталом и Edge.

Как найти страницу разработчика

Как открыть страницу разработчика в интерфейсе Edge и новом интерфейсе Edge

Как добавить разработчика

Чтобы добавить разработчика:

1. Перейдите на страницу разработчиков.
2. Нажмите + Разработчик.
3. Введите данные разработчика, в том числе имя, фамилию, адрес электронной почты и имя пользователя.
4. Нажмите Создать.

Как посмотреть и изменить информацию о разработчике

Просматривать и изменять информацию о разработчике. Если в организации включена монетизация, вы можете изменять пользовательские атрибуты монетизации, определенные в разделе Настройка атрибутов монетизации.

Чтобы посмотреть и изменить сведения о разработчике:

1. Перейдите на страницу разработчиков.
2. Нажмите на строку разработчика, чтобы посмотреть и изменить его данные.
3. В разделе "Подробности" приведена следующая информация: При необходимости измените информацию о разработчике.

   Подробная информация	Описание
   Сведения	Имя и фамилия разработчика, имя пользователя и адрес электронной почты; статус и продолжительность регистрации; идентификатор разработчика. Чтобы изменить информацию о разработчике, нажмите на любое из следующих полей: Имя Фамилия Электронная почта Имя пользователя Измените контент и нажмите Ввод, чтобы подтвердить изменения.
   Настраиваемые атрибуты	Специальные атрибуты, заданные для разработчика. При необходимости настройте настраиваемые атрибуты. Дополнительная информация: Как управлять настраиваемыми атрибутами разработчика Как настроить атрибуты монетизации
   Приложения	Приложения, зарегистрированные разработчиком. Подробнее о регистрации приложений…

4. Включите или отключите разработчика в поле "Статус".
   Подробнее о том, как включить или отключить разработчика…

В Apigee Edge для общедоступного облака Edge хранит в кеше следующие объекты не менее 180 секунд после того, как к ним был получен доступ.

• токены доступа OAuth; Это означает, что отозванный токен может быть действительным ещё до трех минут, пока не истечет срок его хранения в кеше.
• Объекты сервиса управления ключами (KMS) (приложения, разработчики, продукты API).
• Пользовательские атрибуты в токенах OAuth и объектах KMS.

Как управлять настраиваемыми атрибутами разработчика

Добавьте до 18 специальных атрибутов для каждого разработчика, в том числе атрибуты монетизации, описанные в разделе Настройка атрибутов монетизации.

Чтобы управлять настраиваемыми атрибутами:

1. Перейдите на страницу разработчиков.
2. Нажмите на строку разработчика, для которого вы хотите управлять специальными атрибутами, чтобы открыть сведения о нем.
3. Нажмите + в разделе "Настраиваемые атрибуты".
4. Введите название и значение атрибута.
5. Нажмите .
6. Чтобы удалить настраиваемый атрибут, наведите на него указатель и нажмите в меню действий.

Как активировать и деактивировать разработчика

Когда разработчик приложений самостоятельно регистрируется в вашем портале, вы можете настроить, будет ли его аккаунт активен по умолчанию.

Если аккаунт разработчика неактивен, он может войти на портал для разработчиков и создать приложение, но ни один из связанных с ним ключей API работать не будет. Приложения разработчика и ключи API сохраняют свой статус (одобрено или другой), даже если они недействительны, пока разработчик неактивен.

Чтобы активировать или деактивировать разработчика:

1. Перейдите на страницу разработчиков.
2. Нажмите на строку разработчика, которого хотите активировать или деактивировать, чтобы открыть сведения о нем.
3. В разделе "Сведения" задайте для поля Статус значение Активно или Неактивно.
4. Повторите эти действия, если разработчик входит в несколько организаций.

Экспорт данных о публикациях

Экспортируйте следующие данные об издании в виде файла со значениями, разделенными запятыми (CSV):

• Сведения о разработчике
• Сведения о разработчике, приложении и продукте API

Чтобы экспортировать данные о публикациях:

1. Перейдите на страницу разработчиков.
2. Нажмите Экспортировать в CSV….
3. В раскрывающемся списке выберите Разработчики или Разработчики, приложения и продукты.

Выбранные данные будут скачаны в виде CSV-файла.

Как удалить разработчика

Чтобы удалить разработчика:

1. Перейдите на страницу разработчиков.
2. Наведите курсор на строку с нужным разработчиком, чтобы открыть меню действий.
3. Нажмите .
4. Нажмите Удалить, чтобы подтвердить свое решение.

Синхронизация разработчиков приложений между порталом и Edge

Если вы используете портал для разработчиков на основе Drupal для публикации API, изменения, внесенные в аккаунты разработчиков приложений с помощью Edge, не будут отражены на портале. Чтобы изменения появились на портале, войдите на него как администратор и синхронизируйте его с Edge.

Чтобы синхронизировать портал для разработчиков с разработчиками приложений, определенными в Edge, следуйте инструкциям в следующих разделах:

• Drupal 10: синхронизация разработчиков с Apigee Edge
• Drupal 7: синхронизация разработчиков приложений между порталом и Edge

Группировка разработчиков по компаниям

В контексте монетизации компания – это группа разработчиков, управляемая как единое целое. Компания может представлять собой любую группу, подходящую для вашей организации, например подразделение, товарную линейку или отдел. Группировка разработчиков по компаниям полезна, если вам нужно, чтобы несколько разработчиков были связаны с одной корпоративной организацией. Например, вам может понадобиться настроить разные компании для целей оплаты. Однако разработчики в вашей организации не обязаны быть связаны с компанией. Обратите внимание, что разработчик всегда является одним лицом, уникально идентифицируемым по элементу электронной почты. Если разработчик является частью компании, на странице "Разработчики" будет указано название компании.

Подробнее о том, как управлять компаниями и разработчиками для монетизации…

Как настроить атрибуты монетизации

При редактировании разработчика в интерфейсе или создании или изменении разработчика с помощью API можно настроить свойства монетизации, указанные в таблице ниже. Первоначально вы настраиваете свойства монетизации для организации при редактировании профиля организации.

Название поля	Название настраиваемого атрибута	Описание
Адрес	MINT_DEVELOPER_ADDRESS	Адрес разработчика, включая следующие поля: "Адрес" (строки 1 и 2), "Город", "Штат", "Почтовый индекс" и "Страна".
Платежный профиль	MINT_BILLING_PROFILE	Платежный цикл организации. Действительные значения: PRORATED: оплата взимается в зависимости от количества дней использования продукта API в календарном месяце. CALENDAR_MONTH: оплата взимается ежемесячно.
Способ оплаты	MINT_BILLING_TYPE	Модель оплаты, используемая для выставления счетов разработчику. Возможные значения: ПРЕДОПЛАТА. Разработчик заранее оплачивает использование продукта API. Средства списываются с баланса разработчика при использовании продукта API. У разработчика должна быть достаточная сумма предоплаты для покупки продукта API. POSTPAID Разработчику ежемесячно выставляется счет за использование продуктов API. Разработчик оплачивает использование продуктов API в соответствии с условиями оплаты, указанными в тарифных планах, включенных в счет. BOTH – поддерживаются оба типа оплаты. Значение по умолчанию – PREPAID. Подробнее о том, как настроить типы оплаты по факту и с предоплатой с помощью API…
Категория	MINT_DEVELOPER_CATEGORY	Категория разработчика, в которую вы хотите добавить разработчика. Категория разработчиков – это группа разработчиков или компаний со схожими характеристиками. Подробнее о том, как управлять категориями разработчиков…
Идентификатор компании	MINT_COMPANY_ID	Идентификатор компании, если применимо. Подробнее о том, как объединять разработчиков в компании…
Тип разработчика	MINT_DEVELOPER_TYPE	Это свойство не используется Apigee. Тип разработчика. Допустимые значения: TRUSTED или UNTRUSTED.
Брокер	MINT_IS_BROKER	Флаг, указывающий, основан ли доход на чистой прибыли.
Полное имя	MINT_DEVELOPER_LEGAL_NAME	Полное имя разработчика, которое будет использоваться во всех отчетах. Примечание. Этот атрибут обязателен, если разработчик не входит в группу с компанией и хочет подписаться на опубликованный тарифный план.
Самовыставление счетов	MINT_HAS_SELF_BILLING	Отметка, указывающая, включены ли счета, выставляемые самостоятельно. Если она включена (true), то вместо отчета о распределении дохода создается счет с самовыставлением. Счет с самовыставлением – это финансовый документ, в котором указана сумма, которую нужно выплатить разработчику. Он действует как счет для поставщика API от имени разработчика.
Номер разрешения на освобождение от уплаты налогов	MINT_TAX_EXEMPT_AUTH_NO	Номер налоговой льготы (если применимо).
Ставка налога	MINT_APPROX_TAX_RATE	Приблизительная налоговая ставка для разработчика. Укажите десятичное значение, в котором до запятой не более трех символов, а после – не более четырех.

Как управлять разработчиками с помощью API

Управлять разработчиками с помощью Developer API.

При создании и изменении аккаунта разработчика с помощью API вы можете настроить атрибуты монетизации, описанные в разделе Настройка атрибутов монетизации.