subscriptions_test_kit 0.9.0

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage/event_notification/id_only_content_group.rb

@@ -0,0 +1,58 @@
+require_relative '../../common/interaction_group'
+require_relative '../../common/interaction_verification_group'
+require_relative 'id_only_content/id_only_conformance_test'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class IdOnlyContentGroup < Inferno::TestGroup
+      id :subscriptions_r5_backport_r4_server_id_only_content
+      title 'Id Only Notification Verification'
+      description %(
+        Verify that the received Notifications are conformant to the
+        [R4 Topic-Based Subscription Notification Bundle](https://hl7.org/fhir/uv/subscriptions-backport/STU1.1/StructureDefinition-backport-subscription-notification-r4.html)
+        profile, including additional requirements around the `id-only` content type ([example id-only
+        Subscription](https://github.com/inferno-framework/subscriptions-test-kit/blob/main/lib/subscriptions_test_kit/docs/samples/Subscription_id-only.json)).
+      )
+      run_as_group
+      optional
+
+      input_order :url, :credentials, :access_token, :id_only_subscription_resource
+
+      group from: :subscriptions_r5_backport_r4_server_interaction do
+        id :subscriptions_r5_backport_r4_server_id_only_content_interaction
+        optional
+
+        config(
+          options: { subscription_type: 'id-only' },
+          inputs: {
+            subscription_resource: {
+              name: :id_only_subscription_resource,
+              title: 'Id-Only Notification Subscription Resource',
+              type: 'textarea',
+              description: %(
+                A Subscription resource in JSON format that Inferno will send to the server under test
+                so that it can demonstrate its ability to send an id-only Notification. 
+                The instance must be conformant to the R4/B Topic-Based Subscription profile.
+                Inferno may modify the Subscription before submission, e.g., to point to Inferno's notification endpoint.
+            ),
+              optional: true
+            },
+            updated_subscription: { name: :id_only_updated_subscription }
+          },
+          outputs: {
+            updated_subscription: { name: :id_only_updated_subscription }
+          }
+        )
+      end
+      group from: :subscriptions_r5_backport_r4_server_interaction_verification do
+        id :subscriptions_r5_backport_r4_server_id_only_content_interaction_verification
+        optional
+
+        config(
+          options: { subscription_type: 'id-only' }
+        )
+        test from: :subscriptions_r5_backport_r4_server_id_only_conformance
+      end
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage/event_notification_group.rb

@@ -0,0 +1,25 @@
+require_relative 'event_notification/empty_content_group'
+require_relative 'event_notification/full_resource_content_group'
+require_relative 'event_notification/id_only_content_group'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class EventNotificationGroup < Inferno::TestGroup
+      id :subscriptions_r5_backport_r4_server_event_notification
+      title 'Backport Subscription Notification Verification'
+      description %(
+        Verify that the received Notifications are conformant to the
+        [R4 Topic-Based Subscription Notification Bundle](https://hl7.org/fhir/uv/subscriptions-backport/STU1.1/StructureDefinition-backport-subscription-notification-r4.html)
+        profile, including additional requirements around the content type. This group contains tests for the three options
+        available when specifying the contents of a Notification: empty, id-only, and full-resource.
+      )
+
+      input_order :url, :credentials, :access_token, :empty_subscription_resource,
+                  :id_only_subscription_resource, :full_resource_subscription_resource
+
+      group from: :subscriptions_r5_backport_r4_server_empty_content
+      group from: :subscriptions_r5_backport_r4_server_id_only_content
+      group from: :subscriptions_r5_backport_r4_server_full_resource_content
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage/handshake_heartbeat/handshake_conformance_test.rb

@@ -0,0 +1,67 @@
+require_relative '../../../../common/notification_conformance_verification'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class HandshakeConformanceTest < Inferno::Test
+      include NotificationConformanceVerification
+
+      id :subscriptions_r5_backport_r4_server_handshake_conformance
+      title 'Subscription Handshake Verification'
+      description %(
+        When a Subscription is created for a REST Hook channel type, the server SHALL set initial status to requested,
+        pending verification of the nominated endpoint URL. The Server will then send a handshake bundle to the endpoint.
+        After a successful handshake notification has been sent and accepted, the server SHALL update the status to
+        active. This test verifies that the incoming handshake request is a conformant
+        [R4 Topic-Based Subscription Notification Bundle](https://hl7.org/fhir/uv/subscriptions-backport/STU1.1/StructureDefinition-backport-subscription-notification-r4.html).
+      )
+
+      verifies_requirements 'hl7.fhir.uv.subscriptions_1.1.0@14',
+                            'hl7.fhir.uv.subscriptions_1.1.0@15',
+                            'hl7.fhir.uv.subscriptions_1.1.0@28',
+                            'hl7.fhir.uv.subscriptions_1.1.0@69',
+                            'hl7.fhir.uv.subscriptions_1.1.0@70',
+                            'hl7.fhir.uv.subscriptions_1.1.0@24',
+                            'hl7.fhir.uv.subscriptions_1.1.0@25',
+                            'hl7.fhir.uv.subscriptions_1.1.0@138',
+                            'hl7.fhir.uv.subscriptions_1.1.0@139'
+
+      run do
+        subscription_requests = load_tagged_requests('subscription_creation')
+        skip_if(subscription_requests.empty?, %(
+          No Subscription creation requests were made in previous tests. Must run Subscription Workflow tests first in
+          order to run this test.))
+
+        subscription_request_ids =
+          subscription_requests
+            .select { |request| request.status == 201 }
+            .uniq(&:response_body)
+            .map { |request| JSON.parse(request.response_body) }
+            .select { |subscription| subscription['channel']['type'] == 'rest-hook' }
+            .map { |subscription| subscription['id'] }
+
+        requests = load_tagged_requests('handshake')
+        if requests.empty?
+          omit_if subscription_request_ids.empty?, 'No handshake requests were required or received in a previous tests.'
+          assert(subscription_request_ids.empty?,
+                'Handshake requests are required if a Subscription channel type is `rest-hook`')
+        end
+
+        requests = requests.uniq(&:request_body)
+
+        requests.each do |request|
+          tags = request.tags.dup
+          tags -= ['handshake']
+          subscription_id = tags.first
+
+          subscription_request_ids.delete(subscription_id)
+
+          notification_verification(request.request_body, 'handshake', subscription_id:, status: 'requested')
+        end
+
+        no_error_verification('Received handshakes are not conformant.')
+        assert(subscription_request_ids.empty?,
+              'Did not receive a handshake notification for some `rest-hook` subscriptions')
+      end
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage/handshake_heartbeat/heartbeat_conformance_test.rb

@@ -0,0 +1,74 @@
+require_relative '../../../../common/notification_conformance_verification'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class HeartbeatConformanceTest < Inferno::Test
+      include NotificationConformanceVerification
+
+      id :subscriptions_r5_backport_r4_server_heartbeat_conformance
+      title 'Subscription Heartbeat Verification'
+      description %(
+        When a Subscription is created for a REST Hook channel type, the server Server may send notifications of type
+        heartbeat at any time. This test verifies that the incoming heartbeat request is a conformant
+        [R4 Topic-Based Subscription Notification Bundle](https://hl7.org/fhir/uv/subscriptions-backport/STU1.1/StructureDefinition-backport-subscription-notification-r4.html).
+      )
+
+      verifies_requirements 'hl7.fhir.uv.subscriptions_1.1.0@14',
+                            'hl7.fhir.uv.subscriptions_1.1.0@15',
+                            'hl7.fhir.uv.subscriptions_1.1.0@28',
+                            'hl7.fhir.uv.subscriptions_1.1.0@69',
+                            'hl7.fhir.uv.subscriptions_1.1.0@70',
+                            'hl7.fhir.uv.subscriptions_1.1.0@138',
+                            'hl7.fhir.uv.subscriptions_1.1.0@139',
+                            'hl7.fhir.uv.subscriptions_1.1.0@93',
+                            'hl7.fhir.uv.subscriptions_1.1.0@94'
+
+      def heartbeat_period?(subscription_extensions)
+        return false if subscription_extensions.blank?
+
+        heartbeat = subscription_extensions.find { |extension| extension['url'].ends_with?('/backport-heartbeat-period') }
+
+        return false if heartbeat.blank?
+
+        heartbeat['valueUnsignedInt'].present?
+      end
+
+      run do
+        subscription_requests = load_tagged_requests('subscription_creation')
+        skip_if(subscription_requests.empty?, %(
+          No Subscription creation requests were made in previous tests. Must run Subscription Workflow tests first in
+          order to run this test.))
+
+        subscription_request_ids =
+          subscription_requests
+            .select { |request| request.status == 201 }
+            .uniq(&:response_body)
+            .map { |request| JSON.parse(request.response_body) }
+            .select { |subscription| heartbeat_period?(subscription['channel']['extension']) }
+            .map { |subscription| subscription['id'] }
+
+        requests = load_tagged_requests('heartbeat')
+        if requests.empty?
+          omit_if subscription_request_ids.empty?, 'No heartbeat requests requested or received in previous tests.'
+          assert(subscription_request_ids.empty?, %(
+              No Heartbeat notifications received when heartbeat was requested by the subscriber (`heartbeatPeriod` is
+              populated)))
+        end
+
+        requests = requests.uniq(&:request_body)
+
+        requests.each do |request|
+          tags = request.tags.dup
+          tags -= ['heartbeat']
+          subscription_id = tags.first
+
+          assert(subscription_request_ids.include?(subscription_id),
+                'If `heartbeatPeriod` field is not present in the Subscription, heartbeat should not be sent.')
+
+          notification_verification(request.request_body, 'heartbeat', subscription_id:)
+          no_error_verification('Received heartbeats are not conformant.')
+        end
+      end
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage/handshake_heartbeat_group.rb

@@ -0,0 +1,19 @@
+require_relative 'handshake_heartbeat/handshake_conformance_test'
+require_relative 'handshake_heartbeat/heartbeat_conformance_test'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class HandshakeHeartbeatGroup < Inferno::TestGroup
+      id :subscriptions_r5_backport_r4_server_handshake_heartbeat
+      title 'Backport Subscription Handshake and Heartbeat Notification Verification'
+      description %(
+        Verify that the any received Handshake or Heartbeat Notifications are conformant to the
+        [R4 Topic-Based Subscription Notification Bundle](https://hl7.org/fhir/uv/subscriptions-backport/STU1.1/StructureDefinition-backport-subscription-notification-r4.html)
+        profile.
+      )
+
+      test from: :subscriptions_r5_backport_r4_server_handshake_conformance
+      test from: :subscriptions_r5_backport_r4_server_heartbeat_conformance
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage/status_operation/status_invocation_test.rb

@@ -0,0 +1,43 @@
+require_relative '../../common/subscription_status_operation'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class StatusInvocationTest < Inferno::Test
+      include SubscriptionStatusOperation
+
+      id :subscriptions_r5_backport_r4_server_status_invocation
+      title 'Server supports subscription $status operation'
+      description %(
+        In order to claim conformance with this guide, a server: SHALL support the [$status operation](https://hl7.org/fhir/uv/subscriptions-backport/STU1.1/OperationDefinition-backport-subscription-status.html)
+        on the Subscription resource. This operation is used to return the current status information about one or more
+        topic-based Subscriptions in R4. The operation returns a bundle containing one or more subscription status
+        resources, one per Subscription being queried. The Bundle type is "searchset". The status of the Subscription
+        should be set to 'active' after a successful handshake with the rest-hook endpoint.
+
+        This test ensures the server supports the $status operation by performing the operation and ensuring it receives a
+        valid response.
+      )
+
+      verifies_requirements 'hl7.fhir.uv.subscriptions_1.1.0@20',
+                            'hl7.fhir.uv.subscriptions_1.1.0@30',
+                            'hl7.fhir.uv.subscriptions_1.1.0@47'
+
+      run do
+        subscription_requests = load_tagged_requests('subscription_creation')
+        success_subscription_requests =
+          subscription_requests
+            .select { |request| request.status == 201 }
+        skip_if success_subscription_requests.empty?, %(
+          No successful Subscription creation requests were made in previous tests. Must run Subscription Workflow tests
+          first in order to run this test.
+        )
+
+        subscription = JSON.parse(success_subscription_requests.first.response_body)
+        subscription_id = subscription['id']
+
+        perform_subscription_status_test(subscription_id)
+        no_error_verification('Subscription status response was not conformant.')
+      end
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage/status_operation_group.rb

@@ -0,0 +1,15 @@
+require_relative 'status_operation/status_invocation_test'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class StatusOperationGroup < Inferno::TestGroup
+      id :subscriptions_r5_backport_r4_server_status_operation
+      title 'Subscription $status Operation Verification'
+      description %(
+        This test group verifies that the Backport Subscriptions Server supports the $status operation.
+      )
+      
+      test from: :subscriptions_r5_backport_r4_server_status_invocation
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage/subscription_rejection/reject_subscriptions_test.rb

@@ -0,0 +1,181 @@
+require_relative '../../common/subscription_creation'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class RejectSubscriptionsTest < Inferno::Test
+      include SubscriptionCreation
+
+      id :subscriptions_r5_backport_r4_server_reject_subscriptions
+      title 'Server Handles Unsupported Subscriptions'
+      description %(
+        When processing a request for a Subscription a server SHOULD verify that the Subscription is supported and does not
+        contain any information not implemented by the server. If the Subscription is no supported, the server should reject
+        the Subscription create request, or it should attempt to adjust the Subscription. This test checks that the server
+        correctly rejects or adjusts the Subscription in the following cases:
+
+          - The Subscription contains cross-version extension
+          - The Subscription contains a Subscription Topic not implemented by the server
+          - The Subscription contains a filtering criteria not implemented by the server
+          - The Subscription contains channel type not implemented by the server
+          - The Subscription contains an unsupported channel endpoint
+          - The Subscription contains a payload type not implemented by the server
+          - The Subscription contains an unsupported channel and payload type combination
+
+        The test will pass if the server either 
+        1. rejects the Subscription by responding with a non-201 response, or
+        2. updates the Subscription resource to remove or replace the unsupported value.
+      )
+
+      verifies_requirements 'hl7.fhir.uv.subscriptions_1.1.0@8',
+                            'hl7.fhir.uv.subscriptions_1.1.0@9',
+                            'hl7.fhir.uv.subscriptions_1.1.0@10',
+                            'hl7.fhir.uv.subscriptions_1.1.0@11',
+                            'hl7.fhir.uv.subscriptions_1.1.0@12',
+                            'hl7.fhir.uv.subscriptions_1.1.0@13'
+
+      input :subscription_resource,
+            title: 'Workflow Subscription Resource',
+            type: 'textarea',
+            description: %(
+              A Subscription resource in JSON format that Inferno will send to the server under test
+              so that it can demonstrate its ability to perform the Subscription creation and Notification
+              response workflow. The instance must be conformant to the R4/B Topic-Based Subscription profile.
+              Inferno may modify the Subscription before submission, e.g., to point to Inferno's notification endpoint.
+              This input is also used by the unsupported Subscription test as the base on which to add unsupported element
+              values to test for server rejection.
+            )
+      input :unsupported_subscription_topic,
+            title: 'Unsupported Subscription Topic',
+            description: 'A Subscription Topic for the `criteria` element that is not implemented by the server to test for Subscription rejection.',
+            optional: true
+      input :unsupported_subscription_filter,
+            title: 'Unsupported Subscription Filter',
+            description: 'A value for `filterCriteria` extension under the `criteria` that is not implemented by the server to test for Subscription rejection.',
+            optional: true
+      input :unsupported_subscription_channel_type,
+            title: 'Unsupported Subscription Channel Type',
+            description: 'A value for the `channel.type` element that is not implemented by the server to test for Subscription rejection.',
+            optional: true
+      input :unsupported_subscription_channel_endpoint,
+            title: 'Unsupported Subscription Channel Endpoint',
+            description: 'An unsupported value for the `channel.endpoint` element to test for Subscription rejection.',
+            optional: true
+      input :unsupported_subscription_payload_type,
+            title: 'Unsupported Subscription Payload Type',
+            description: 'A value for the `content` extension under the `channel.payload` element that is not implemented by the server to test for Subscription rejection.',
+            optional: true
+      input :unsupported_subscription_channel_payload_combo,
+            title: 'Unsupported Subscription Channel and Payload Combination',
+            description: %(
+              A channel (`channel.type`) and payload type (`content` extension under the `channel.payload` element) 
+              combination not implemented by the server to test for Subscription
+              rejection. Provide in the json format e.g. {channel: <'channel_type'>, payload: <'payload_type'>}.
+            ),
+            optional: true
+
+      def unsupported_subscriptions
+        [
+          {
+            'unsupported_title' => 'cross-version extensions',
+            'field_path' => ['_criteria'],
+            'field_value' => { 'extension' => [{
+              url: 'http://hl7.org/fhir/5.0/subscriptions-backport/StructureDefinition/backport-filter-criteria',
+              valueString: 'Encounter?patient=Patient/123'
+            }] }
+          },
+          {
+            'unsupported_title' => 'unsupported `SubscriptionTopic`',
+            'field_path' => ['criteria'],
+            'field_value' => unsupported_subscription_topic
+          },
+          {
+            'unsupported_title' => 'unsupported filter criteria',
+            'field_path' => ['_criteria'],
+            'field_value' => if unsupported_subscription_filter.nil?
+                              unsupported_subscription_filter
+                            else
+                              { 'extension' => [{
+                                url: 'http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-filter-criteria',
+                                valueString: unsupported_subscription_filter
+                              }] }
+                            end
+          },
+          {
+            'unsupported_title' => 'unsupported channel type',
+            'field_path' => ['channel', 'type'],
+            'field_value' => unsupported_subscription_channel_type
+          },
+          {
+            'unsupported_title' => 'unsupported channel URL',
+            'field_path' => ['channel', 'endpoint'],
+            'field_value' => unsupported_subscription_channel_endpoint
+          },
+          {
+            'unsupported_title' => 'unsupported channel type',
+            'field_path' => ['channel', 'type'],
+            'field_value' => unsupported_subscription_channel_type
+          },
+          {
+            'unsupported_title' => 'unsupported payload type',
+            'field_path' => ['channel', 'payload'],
+            'field_value' => unsupported_subscription_payload_type
+          }
+        ]
+      end
+
+      run do
+        assert_valid_json(subscription_resource)
+        subscription = JSON.parse(subscription_resource)
+
+        unsupported_subscriptions.each do |unsupported_info|
+          next if unsupported_info['field_value'].blank?
+
+          field_name = unsupported_info['field_path'].last
+
+          if unsupported_info['field_path'].length > 1
+            outer_field_name = unsupported_info['field_path'].first
+            subscription_field = subscription[outer_field_name]
+          else
+            subscription_field = subscription
+          end
+
+          original_field_value = subscription_field[field_name]
+          subscription_field[field_name] = unsupported_info['field_value']
+
+          send_unsupported_subscription(subscription, unsupported_info['unsupported_title'], [unsupported_info['field_path']],
+                                    [unsupported_info['field_value']])
+
+          if original_field_value.nil?
+            subscription_field.delete(field_name)
+          else
+            subscription_field[field_name] = original_field_value
+          end
+        end
+
+        if unsupported_subscription_channel_payload_combo.present?
+          assert_valid_json(unsupported_subscription_channel_payload_combo)
+          channel_payload_combo = JSON.parse(unsupported_subscription_channel_payload_combo)
+          channel_value = channel_payload_combo['channel']
+          payload_value = channel_payload_combo['payload']
+
+          if channel_value.blank? || payload_value.blank?
+            add_message('error', %(
+                Channel and payload values are not populated correctly in unsupported channel and payload combination input.))
+          else
+            subscription_channel = subscription['channel']
+            subscription_channel['type'] = channel_value
+            subscription_channel['payload'] = payload_value
+
+            channel_path = ['channel', 'type']
+            payload_path = ['channel', 'payload']
+
+            send_unsupported_subscription(subscription, 'unsupported channel and payload combination', [channel_path, payload_path],
+                                      [channel_value, payload_value])
+          end
+        end
+
+        no_error_verification('Unsupported Subscription creation error handling failures.')
+      end
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage/subscription_rejection_group.rb

@@ -0,0 +1,21 @@
+require_relative 'subscription_rejection/reject_subscriptions_test'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class SubscriptionRejectionGroup < Inferno::TestGroup
+      id :subscriptions_r5_backport_r4_server_subscription_rejection
+      title 'Subscription Creation Rejection Verification'
+      description %(
+        This test group verifies that the Backport Subscriptions Server supports rejecting unsupported
+        Subscription creation requests.
+      )
+
+      input_order :url, :credentials, :subscription_resource, :unsupported_subscription_topic,
+                  :unsupported_subscription_filter, :unsupported_subscription_channel_type,
+                  :unsupported_subscription_channel_endpoint, :unsupported_subscription_payload_type,
+                  :unsupported_subscription_channel_payload_combo
+
+      test from: :subscriptions_r5_backport_r4_server_reject_subscriptions
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/coverage_group.rb

@@ -0,0 +1,26 @@
+require_relative 'coverage/capability_statement_group'
+require_relative 'coverage/event_notification_group'
+require_relative 'coverage/handshake_heartbeat_group'
+require_relative 'coverage/status_operation_group'
+require_relative 'coverage/subscription_rejection_group'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    module Coverage
+      class GroupForCoverage < Inferno::TestGroup
+        id :subscriptions_r5_backport_r4_server_coverage
+        title 'Demonstrate coverage of all Subscription Backport IG requirements'
+        description %(
+          Demonstrate that the server covers all requirements placed on
+          servers by the IG.
+        )
+
+        group from: :subscriptions_r5_backport_r4_server_capability_statement
+        group from: :subscriptions_r5_backport_r4_server_event_notification
+        group from: :subscriptions_r5_backport_r4_server_handshake_heartbeat
+        group from: :subscriptions_r5_backport_r4_server_status_operation
+        group from: :subscriptions_r5_backport_r4_server_subscription_rejection
+      end
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server/workflow_group.rb

@@ -0,0 +1,27 @@
+require_relative 'common/interaction_group'
+require_relative 'common/interaction_verification_group'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class WorkflowGroup < Inferno::TestGroup
+      id :subscriptions_r5_backport_r4_server_workflow
+      title 'Demonstrate the subscription workflow'
+      description %(
+        Demonstrate the ability of the server to accept a request for the
+        creation of a FHIR Subscription instance and deliver a notification
+        for that Subscription. The tester must provide a Subscription instance
+        that the server under test supports. Inferno will act as a client,
+        creating the Subscription and waiting for a notification based on it.
+        Inferno will then verify that the Subscription and the Notification
+        match and that the exchange is conformant.
+      )
+
+      run_as_group
+
+      input_order :url, :credentials, :access_token, :subscription_resource
+
+      group from: :subscriptions_r5_backport_r4_server_interaction
+      group from: :subscriptions_r5_backport_r4_server_interaction_verification
+    end
+  end
+end

data/lib/subscriptions_test_kit/suites/subscriptions_r5_backport_r4_server_suite.rb

@@ -0,0 +1,79 @@
+require_relative 'subscriptions_r5_backport_r4_server/workflow_group'
+require_relative 'subscriptions_r5_backport_r4_server/coverage_group'
+require_relative '../endpoints/subscription_rest_hook_endpoint'
+require_relative '../urls'
+require_relative '../version'
+
+module SubscriptionsTestKit
+  module SubscriptionsR5BackportR4Server
+    class SubscriptionsR5BackportR4ServerSuite < Inferno::TestSuite
+      id :subscriptions_r5_backport_r4_server
+      title 'Subscriptions R5 Backport IG v1.1.0 FHIR R4 Server Test Suite'
+      short_title 'Subscriptions R4 Server'
+      version VERSION
+      description File.read(File.join(__dir__, '..', 'docs', 'subscriptions_r5_backport_r4_server_suite_description.md'))
+
+      links [
+        {
+          label: 'Report Issue',
+          url: 'https://github.com/inferno-framework/subscriptions-test-kit/issues'
+        },
+        {
+          label: 'Open Source',
+          url: 'https://github.com/inferno-framework/subscriptions-test-kit'
+        },
+        {
+          label: 'Download',
+          url: 'https://github.com/inferno-framework/subscriptions-test-kit/releases'
+        },
+        {
+          label: 'Implementation Guide',
+          url: 'https://hl7.org/fhir/uv/subscriptions-backport/STU1.1/'
+        }
+      ]
+      
+      # These inputs will be available to all tests in this suite
+      input :url,
+            title: 'FHIR Server Base URL',
+            description: %(
+                            FHIR base URL for the server under test where Inferno will send
+                            Subscription Creation, $status, and other requests as a part of
+                            these tests.
+                          )
+
+      input :credentials,
+            title: 'OAuth Credentials',
+            description: 'Credentials for Inferno to include when making requests against the server under test.',
+            type: :oauth_credentials,
+            optional: true
+
+      # All FHIR requests in this suite will use this FHIR client
+      fhir_client do
+        url :url
+        oauth_credentials :credentials
+      end
+
+      # All FHIR validation requests will use this FHIR validator
+      fhir_resource_validator do
+        igs 'hl7.fhir.uv.subscriptions-backport#1.1.0'
+
+        exclude_message do |message|
+          message.message.match?(/\A\S+: \S+: URL value '.*' does not resolve/)
+        end
+      end
+
+      def self.extract_token_from_query_params(request)
+        request.query_parameters['token']
+      end
+
+      suite_endpoint :post, SUBSCRIPTION_CHANNEL_PATH, SubscriptionRestHookEndpoint
+
+      resume_test_route :get, RESUME_PASS_PATH do |request|
+        SubscriptionsR5BackportR4ServerSuite.extract_token_from_query_params(request)
+      end
+
+      group from: :subscriptions_r5_backport_r4_server_workflow
+      group from: :subscriptions_r5_backport_r4_server_coverage
+    end
+  end
+end

data/lib/subscriptions_test_kit/tags.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module SubscriptionsTestKit
+  NOTIFICATION_TAG = 'subscription_notification'
+  SUBSCRIPTION_CREATE_TAG = 'subscription_create'
+  SUBSCRIPTION_READ_TAG = 'subscription_read'
+  SUBSCRIPTION_STATUS_TAG = 'subscription_status'
+  REST_HOOK_HANDSHAKE_NOTIFICATION_TAG = 'rest_hook_handshake_notification'
+  REST_HOOK_EVENT_NOTIFICATION_TAG = 'rest_hook_event_notification'
+end