Claude Platform Docs
АдминистрированиеClaude Platform OAuth

Тестирование и проверка приложения

Как новое приложение с Linked billing выходит из режима тестирования и становится доступным для ваших клиентов и что происходит при изменении запущенного приложения.

При использовании Linked billing клиент связывает свою организацию Claude с вашим приложением OAuth. Новое приложение с Linked billing начинает работу в режиме тестирования, в котором связать с ним свои организации могут только назначенные вами «test users» (тестовые пользователи). Чтобы открыть приложение для ваших клиентов, вы публикуете его, и Anthropic проводит его проверку.

Если ваша организация оплачивает услуги по выставленным счетам, Anthropic не проверяет ваше приложение. См. Оплата по выставленным счетам.

Приложение считается запущенным, когда Anthropic одобрила его или когда вы опубликовали его при оплате по выставленным счетам. Любой подходящий клиент может связать свою организацию с запущенным приложением, а связи, созданные его тестовыми пользователями, сохраняются. На странице приложений OAuth в Claude Console статус запущенного приложения отображается как Active.

Пока приложение не запущено, Console показывает для него один из следующих статусов:

СтатусЧто это означает
TestingВы не опубликовали приложение.
In reviewAnthropic проверяет приложение или изменение, которое вы внесли, пока приложение было запущено.
Not approvedAnthropic проверила приложение или изменение и не одобрила его.

Приложение, которое вернулось на проверку после изменения, не считается снова запущенным, пока Anthropic не одобрит изменение. У каждого приложения с Linked billing есть собственный статус и собственные тестовые пользователи. См. примечание в разделе Шаг 1: Создайте приложение руководства по Linked billing.

Перед началом работы

Выполните Процесс настройки из руководства по Linked billing.

Управление тестовыми пользователями

Добавление тестовых пользователей

  1. Откройте страницу приложения на странице приложений OAuth в Console.
  2. На вкладке Settings перейдите к списку Test users в разделе Who can link.
  3. Введите адрес электронной почты учётной записи Claude тестового пользователя и нажмите Add. Повторите для каждого тестового пользователя.
  4. Нажмите Save changes.

После сохранения люди из списка могут связывать свои организации с вашим приложением. Пока ваше приложение не запущено, страница подтверждения Claude, на которой человек подтверждает связь, отказывает всем остальным. О том, что в этом случае получает ваше приложение, см. раздел Ваш URI перенаправления получает error=access_denied руководства по Linked billing.

Параметр Who can link остаётся в значении Test users only, пока приложение не запущено, и изменить его нельзя. Список вмещает до 10 тестовых пользователей. Каждый адрес должен точно совпадать с адресом учётной записи, но регистр букв не имеет значения. Адрес с плюс-тегом, например name+test@example.com, считается адресом, отличным от name@example.com.

Тестовый пользователь связывает свою организацию из вашего приложения и подтверждает связь на той же странице, которую используют ваши клиенты. Ему нужна роль «Администратор» или «Оплата» в этой организации. Это шаги с 4 по 8 руководства по Linked billing. Раздел Тестирование в роли клиента этого руководства проведёт вас через них и объяснит, как проверить, что связь создана.

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

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

Пока ваше приложение не запущено, для каждой новой связи требуется ежемесячный «spend cap» (предел расходов) не более $50 USD. Правила для предела см. в разделе Пока ваше приложение находится в тестировании руководства.

Удаление тестового пользователя

Удаление тестового пользователя вступает в силу сразу. Оно завершает каждую связь с вашим приложением, которую одобрил этот человек. После завершения связи Claude API отклоняет запросы, счета за которые вы выставляете этой организации. См. Ожидаемые ошибки.

  1. Если на вкладке Settings есть несохранённые изменения, нажмите Save changes или Discard. Пока вы этого не сделаете, Console не позволит удалить сохранённого тестового пользователя.
  2. Удалите адрес тестового пользователя из списка Test users.
  3. Когда Console попросит, нажмите Remove, чтобы подтвердить. Нажимать Save changes не нужно.

Публикация приложения

При публикации вас могут попросить доказать, что вы контролируете домен своего приложения, добавив DNS-запись. Затем Anthropic проверяет приложение. Изменение DNS требует времени, поэтому начните заранее, до того как клиентам понадобится связывать свои организации.

Перед публикацией проверьте следующее:

  • Аутентификация клиента настроена. Пока она не настроена, опубликовать приложение нельзя.
  • У вашего приложения есть домашняя страница, которую вы задаёте на вкладке Appearance.
  • Вы можете изменять DNS-записи домена домашней страницы.
  • Каждый «redirect URI» (URI перенаправления) находится на домене домашней страницы или на одном из его поддоменов.

Что считается доменом домашней страницы и какие есть исключения, см. в разделе Правила для доменов.

Чтобы опубликовать приложение, выполните следующие шаги:

  1. На странице приложения в Console нажмите Publish app. Откроется диалоговое окно.
  2. Если в диалоговом окне отображается Prove your domain, добавьте DNS-запись TXT, которую оно выдаёт, там, где вы управляете DNS вашего домена. В противном случае перейдите к шагу 5.
  3. Нажмите Check. Если для домена по-прежнему отображается Not proven yet, см. Если не удаётся подтвердить домен.
  4. Когда для домена отобразится Proven, нажмите Continue.
  5. Если в диалоговом окне отображается флажок для принятия Linked Billing Terms, установите его. Затем нажмите Publish app в диалоговом окне, чтобы подтвердить.

Пока Anthropic проверяет приложение, его статус — In review. О результатах см. Проверка.

Если не удаётся подтвердить домен

  • Для домена по-прежнему отображается Not proven yet: Вступление изменения DNS в силу может занять до 48 часов. Вы можете закрыть диалоговое окно и вернуться позже. Если вы публиковали приложение, снова нажмите Publish app. Если вы изменяли запущенное приложение, внесите то же изменение ещё раз, и Console будет выдавать вам ту же запись, пока не истечёт её срок действия.
  • Check сообщает, что срок действия записи истёк: DNS-запись действует 30 дней с момента, когда Console впервые её показывает. После этого нажмите Get a new record и добавьте новую запись. Домен, для которого отображается Proven, остаётся подтверждённым.
  • Вместо записи диалоговое окно показывает сообщение: Например, в сообщении может говориться, что у вашей организации уже есть 20 доменных имён. Продолжить нельзя, пока это не будет решено. Если вам нужна помощь, обратитесь в службу поддержки.

Правила для доменов

Домен — это имя хоста без начального www., а ваш домен — это домен вашей домашней страницы. Например, домен домашней страницы по адресу https://www.example.com — это example.com. Подтверждённый домен охватывает себя и свои поддомены.

  • Общие домены: Общий домен хостинг-сервиса не подходит, поэтому используйте собственный домен.
  • Локальные URI перенаправления: URI перенаправления на localhost, 127.0.0.1 или [::1] не обязаны находиться на домене домашней страницы.
  • Соседние поддомены: Если ваша домашняя страница находится на app.example.com, вашим доменом является этот поддомен, и он не охватывает URI перенаправления на auth.example.com. Один из способов использовать оба — разместить домашнюю страницу на example.com, который охватывает их.
  • Домен, который ваша организация уже подтвердила: Ваша организация могла подтвердить домен ранее, например для другого приложения. Если он охватывает вашу домашнюю страницу и каждый нелокальный URI перенаправления, диалоговое окно пропускает Prove your domain. В этом случае URI перенаправления не обязаны находиться на домене домашней страницы. Например, если подтверждён example.com, домашняя страница и URI перенаправления могут находиться на разных его поддоменах.

Проверка

Когда проверка завершается, страница приложения в Console показывает результат:

  • Anthropic одобряет приложение: Приложение запущено. После этого Who can link показывает Any Claude user без каких-либо действий с вашей стороны, а Console скрывает список Test users.
  • Anthropic не одобряет приложение: Статус приложения меняется на Not approved.

Во время проверки и после результата Not approved ваши тестовые пользователи сохраняют свои связи, и вы по-прежнему можете добавлять и удалять тестовых пользователей.

Если приложение не одобрено

Опубликовать приложение повторно самостоятельно нельзя. Чтобы задать вопрос о решении, обратитесь в службу поддержки. Вы по-прежнему можете изменять приложение, но изменение не запускает новую проверку.

Изменение запущенного приложения

Изменение названия, логотипа, домашней страницы или URI перенаправления запущенного приложения возвращает его на проверку. Пока Anthropic не одобрит изменение, связывать свои организации с приложением могут только ваши тестовые пользователи. См. Пока Anthropic не одобрит изменение. Другие изменения, например разрешений или аутентификации клиента, не возвращают приложение на проверку.

Чтобы изменить название, домашнюю страницу или URI перенаправления, выполните следующие шаги:

  1. Измените приложение на вкладке Appearance (название и домашняя страница) или на вкладке Settings (URI перенаправления).
  2. Нажмите Save changes. Откроется диалоговое окно, прежде чем что-либо будет сохранено.
  3. Если в диалоговом окне отображается Prove your domain, подтвердите каждый домен, который оно называет:
    1. Добавьте DNS-запись TXT для домена. Затем нажмите Check. Если для домена по-прежнему отображается Not proven yet, см. Если не удаётся подтвердить домен.
    2. Когда для домена отобразится Proven, нажмите Next domain, если остался ещё один домен. В противном случае нажмите Continue.
  4. Нажмите Save and send to review.

Затем Console сохраняет изменение, и изменение вступает в силу, не дожидаясь проверки. Пока Anthropic проверяет изменение, статус приложения — In review.

Чтобы изменить логотип, выберите или удалите его на вкладке Appearance. Диалоговое окно откроется сразу. Нажмите Send to review. Если вы отмените действие, логотип не изменится.

Чтобы снова изменить приложение, пока его статус — In review или Not approved, см. Изменение незапущенного приложения.

Когда Console просит подтвердить домен

Console просит об этом, только если вы изменили домашнюю страницу или URI перенаправления. Она также проверяет домашнюю страницу и URI перенаправления, которые вы не изменяли, поэтому диалоговое окно может называть и их домены. Оно называет только домены, которые не охватывает ни один подтверждённый домен вашей организации. Локальные URI перенаправления не проверяются, но изменение одного из них всё равно возвращает приложение на проверку.

После изменения URI перенаправления могут находиться на доменах, отличных от домена домашней страницы, если ваша организация подтвердит каждый из них.

Пока Anthropic не одобрит изменение

Эти правила действуют с момента, когда вы отправляете изменение на проверку:

  • Клиенты, которые уже связали приложение: Их организации остаются связанными, и запросы, счета за которые вы им выставляете, продолжают работать. Клиент, который отменил связь, не может связать приложение снова, если только человек, выполняющий связывание, не находится в списке Test users.
  • Новые связи: Параметр Who can link возвращается к значению Test users only. Console снова показывает список Test users с людьми, которые были в нём раньше.
  • Тестовые пользователи: Вы можете добавлять и удалять людей в списке. Удаление человека также завершает связь, которую он создал с организацией клиента, пока приложение было запущено. См. Удаление тестового пользователя.
  • Пределы расходов связанных организаций: Связанная организация сохраняет текущую настройку предела расходов, даже если её предел выше $50 USD или предела нет. Настройка, которую она изменяет, должна соответствовать правилам из раздела Пока ваше приложение находится в тестировании.

Когда проверка изменения завершается

Проверка завершается одним из двух способов:

  • Anthropic одобряет изменение: Приложение снова запущено. Любой подходящий клиент может связать свою организацию, Console скрывает список Test users, а правила предела для незапущенного приложения больше не применяются.
  • Anthropic не одобряет изменение: Статус приложения меняется на Not approved. Изменение остаётся в силе, и правила из раздела Пока Anthropic не одобрит изменение по-прежнему действуют. См. Если приложение не одобрено.

Изменение незапущенного приложения

Выполните следующие шаги, пока статус приложения — Testing, In review или Not approved:

  1. Измените приложение на вкладке Appearance (название, логотип и домашняя страница) или на вкладке Settings (URI перенаправления).
  2. Нажмите Save changes. Изменение логотипа сохраняется, когда вы выбираете или удаляете логотип.

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

Когда вы сохраняете изменение домашней страницы или URI перенаправления, Console проверяет домены, только пока статус — In review. Приложение в режиме тестирования проходит проверку домена при публикации. Во время проверки домашняя страница изменённого приложения и каждый нелокальный URI перенаправления должны находиться на подтверждённых доменах вашей организации. В противном случае Console отклоняет изменение и не просит подтвердить домен. Чтобы перейти на неподтверждённый домен, дождитесь окончания проверки.

Оплата по выставленным счетам

При оплате по выставленным счетам Anthropic выставляет организации, которой принадлежит ваше приложение, счета за использование API, и эта организация не покупает предоплаченные кредиты. Ваше приложение всё равно начинает работу в режиме тестирования, и правила для тестовых пользователей и предела расходов по-прежнему действуют. После этого отличаются три вещи:

  • Публикация приложения: На странице приложения нажмите Publish app. Затем нажмите Publish app в диалоговом окне, чтобы подтвердить. Anthropic не проверяет приложение, поэтому оно запускается сразу после публикации.
  • Домашняя страница и домен: Вы не подтверждаете домен, поэтому диалоговое окно пропускает Prove your domain. Для публикации вашему приложению не нужна домашняя страница, и правило для URI перенаправления из раздела Публикация приложения не применяется. Аутентификация клиента всё равно должна быть настроена заранее.
  • Изменение запущенного приложения: Console сохраняет изменение, когда вы нажимаете Save changes или когда выбираете или удаляете логотип. Она не просит подтвердить домен или подтвердить изменение, и проверка не следует.

Эта страница была полезной?