AllocationsIT.java

/**
 * Copyright 2007-2015, Kaazing Corporation. All rights reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.kaazing.specification.turn;

import static java.lang.String.format;
import static java.util.concurrent.TimeUnit.SECONDS;
import static org.junit.rules.RuleChain.outerRule;

import java.util.Arrays;
import java.util.Collection;

import org.junit.Rule;
import org.junit.Test;
import org.junit.rules.DisableOnDebug;
import org.junit.rules.TestRule;
import org.junit.rules.Timeout;
import org.junit.runner.RunWith;
import org.junit.runners.Parameterized;
import org.kaazing.k3po.junit.annotation.Specification;
import org.kaazing.k3po.junit.rules.K3poRule;

/**
 * Test to validate behavior as specified in <a href="https://tools.ietf.org/html/rfc5766">RFC 5766: TURN</a> through TCP.
 */
@RunWith(Parameterized.class)
public class AllocationsIT {

    @Parameterized.Parameters
    public static Collection<String> data() {
        return Arrays.asList("tcp", "udp");
    }

    private final K3poRule k3po;

    @Rule
    public final TestRule chain;

    public AllocationsIT(String scheme) {
        k3po = new K3poRule()
            .setScriptRoot("org/kaazing/specification/turn/allocations")
            .scriptProperty(format("acceptURI '%s://localhost:3478'", scheme))
            .scriptProperty(format("connectURI '%s://localhost:3478'", scheme));
        this.chain = outerRule(k3po).around(new DisableOnDebug(new Timeout(5, SECONDS)));
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"simple.allocate.method/request", "simple.allocate.method/response"})
    public void shouldSucceedWithGenericSTUNHeader() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"two.allocate.methods.with.no.credentials/request", "two.allocate.methods.with.no.credentials/response"})
    public void shouldRespondWithTwo401sWhenGivenAllocateMethodsWithNoCred() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"allocate.method.with.requested.transport.attribute/request", "allocate.method.with.requested.transport.attribute/response"})
    public void shouldSucceedWithOnlyTransportAttribute() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"correct.allocation.method/request", "correct.allocation.method/response"})
    public void shouldSucceedWithCorrectAllocation() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"correct.allocation.on.ipv6.method/request", "correct.allocation.on.ipv6.method/response"})
    public void shouldSucceedWithCorrectAllocationOnIpv6() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"attribute.length.over.message.length/request", "attribute.length.over.message.length/response"})
    public void shouldGive400WithIncorrectLength() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"incorrect.attribute.length.with.error.message.length/request",
            "incorrect.attribute.length.with.error.message.length/response"})
    public void shouldGive400WithIncorrectLength2() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"multiple.connections.with.same.credentials.responds.437/request",
            "multiple.connections.with.same.credentials.responds.437/response"})
    public void shouldRespond437ToMultipleConnectionsWithSameCredentials() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"wrong.credentials.responds.441/request", "wrong.credentials.responds.441/response"})
    public void shouldRespond441ToWrongCredentials() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"unknown.attribute.responds.420/request", "unknown.attribute.responds.420/response"})
    public void unknownAttributeShouldRespond420() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"no.requested.transport.attribute.responds.400/request",
            "no.requested.transport.attribute.responds.400/response"})
    public void shouldRespond400ToAllocateWithNoRequestedTransportAttribute() throws Exception {
        k3po.finish();
    }

    /**
     * See <a href="https://tools.ietf.org/html/rfc5766#section-6">RFC 5766 section 6: Allocations</a>.
     */
    @Test
    @Specification({"check.message.digest/request", "check.message.digest/response" })
    public void shouldSucceedWithCorrectMessageDigest() throws Exception {
        k3po.finish();
    }

}