Работа со ссылками

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

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

    <SSLInfo> 
        <Enabled>true</Enabled> 
        <ClientAuthEnabled>false</ClientAuthEnabled> 
        <KeyStore>ref://myTestKeystoreRef</KeyStore> 
        <KeyAlias>myKeyAlias</KeyAlias> 
    </SSLInfo>

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

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

Ограничения на использование ссылок на хранилища ключей и доверенные хранилища

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

  • Ссылки на хранилище ключей и хранилище доверенных сертификатов можно использовать в виртуальных хостах, только если вы поддерживаете SNI и завершаете SSL на маршрутизаторах Apigee.
  • Если перед маршрутизаторами Apigee установлен балансировщик нагрузки, на котором завершается TLS-подключение, то в виртуальных хостах нельзя использовать ссылки на хранилища ключей и доверия.

Как создать ссылку

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

  1. Войдите в интерфейс управления Edge на странице https://enterprise.apigee.com.
  2. В меню интерфейса управления Edge выберите название организации.
  3. В зависимости от версии интерфейса Edge:
    1. Если вы используете классический интерфейс Edge, выберите APIs (API) > Environment Configuration (Конфигурация среды).
    2. Если вы используете новый интерфейс Edge, выберите Администратор > Среды.
  4. Выберите среду (обычно prod или test).
  5. Перейдите на вкладку Цифровые отпечатки.
  6. Нажмите кнопку + Ссылка. Появится следующее всплывающее окно:
  7. Укажите:
    1. Название справочного материала.
    2. Объект, на который указывает ссылка, то есть название хранилища ключей или доверенного хранилища.
    3. Нажмите Сохранить.

Вы также можете использовать вызов API Create Reference, чтобы создать ссылку с именем keystoreref:

curl -X POST  -H "Content-Type:application/xml" https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/references \
-d '<ResourceReference name="keystoreref">
    <Refers>myTestKeystore</Refers>
    <ResourceType>KeyStore</ResourceType>
</ResourceReference>' -u orgAdminEmail:password

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

Изменение ссылки

Чтобы изменить значение ссылки в интерфейсе Edge:

  1. Войдите в интерфейс управления Edge на странице https://enterprise.apigee.com.
  2. В меню интерфейса управления Edge выберите название организации.
  3. В зависимости от версии интерфейса Edge:
    1. Если вы используете классический интерфейс Edge, выберите APIs (API) > Environment Configuration (Конфигурация среды).
    2. Если вы используете новый интерфейс Edge, выберите Администратор > Среды.
  4. Выберите среду (обычно prod или test).
  5. Перейдите на вкладку Цифровые отпечатки.
  6. На вкладке Reference (Справочник) нажмите кнопку Edit (Изменить) рядом с нужным справочником.
  7. Измените ссылку, чтобы указать новое хранилище ключей или доверенное хранилище. Внимание! Псевдоним в новом хранилище ключей должен иметь то же название, что и псевдоним в старом хранилище.
  8. Нажмите Сохранить.

Чтобы изменить ссылку на другое хранилище ключей, убедившись, что псевдоним в новом хранилище имеет то же название, что и в старом, используйте API Update Reference:

curl -X PUT -H "Content-Type:application/xml" https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/references/keystoreref \
-d '<ResourceReference name="keystoreref">
    <Refers>myNewKeystore</Refers>
    <ResourceType>KeyStore</ResourceType>
</ResourceReference>' -u orgAdminEmail:password